post sendNumbersOnline

https://{ourserver.com}/api/resellers/sendNumbersOnline
v2

IMPORTANT NOTE! URL of Onlinesim server is provided by Onlinesim partner support specialists. Please note, that the URL in the example is just a placeholder.

In this request all numbers available for sale should be passed. This request should be sent to Onlinesim server every 5 minutes (to ensure that your server is up and running) and after any change in the number list: after adding new numbers or removing any of previously passed ones.

However, there is another way: you can send checkWork request every 5 minutes (as confirmation that your server is up and running), and use addNumber and removeNumber to add or delete numbers respectively.

IMPORTANT NOTE! Only list of active numbers should be passed in this request. If you have a 32 port device and a 512 port SIM bank, you should send a list with 32 numbers that currently in the ports. Violation of this condition will cause the system to automatically block receiving numbers from you for 30 minutes.

IMPORTANT NOTE! Enabling rent parameter (by assigning value 1 to it) allows clients to rent your number for a longer period, significantly increasing your income. However you need to contact partner support to get a detailed information on terms and requirements before we enable it for your account.

Servers

https://{ourserver.com}

Parameters

Authorization
Required

see more here

In: header
Schema:
  • string
    Example: "Bearer apiKey"

Request Body

Your server should send this request every 5 minutes as a confirmation of uptime or when the list of available numbers is changed (when new numbers are added or previously passed ones are removed).
Content Type:
application/json
  • Schema
  • Examples
  • object
    Example: {"numbers":[{"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}],"test":"test1"}
    Properties:
    • numbers
      array
      Example: [{"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}]
      Items:
      • object
        Example: {"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}
    • test
      string

      Testing parameter. Allowed values are test1, test2. While being assigned, test1 value will allow the request to be passed, however the data won't be saved by our server (the function will not be executed by this request). While being assigned, test2 value will print out your request's payload in response.

      Example: "test1"
      Enum: test1 test2

Responses

200

Onlinesim server response
Content Type:
application/json
  • Schema
  • Examples
  • object
    Example: {"response":1,"ids":{"#number#":0}}
    Properties:
    • response
      mixed
      1, if request was successful, otherwise error message will come up
      Example: 1
      One Of:
      • string
        Example: "string"
      • integer
        Example: 0
    • ids
      object
      Example: {"#number#":0}

400

Bad Request
Content Type:
text/html
  • Schema
  • Examples
  • string
    Error description
    Example: "string"