post sendNumbersOnline

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

ВАЖНО! URL сервера Onlinesim предоставляется сотрудниками партнерской поддержки. Обратите внимание, что URL сервера Onlinesim в примере заменен на заглушку.

В этом запросе следует передавать все доступные для продажи номера. Данный запрос должен отправляться на сервер Onlinesim каждые 5 минут (для подтверждения аптайма Вашего сервера) и после каждого изменения списка номеров: после добавления новых номеров или удаления каких-либо ранее переданных.

Однако, есть альтернативный вариант: для подтверждения аптайма, Вы можете воспользоваться запросом checkWork, а для добавления и удаления номеров - запросами addNumber и removeNumber соответственно.

ВАЖНО! Необходимо, чтобы Ваш сервер возвращал актуальное количество одновременно доступных номеров. Например, если у Вас есть SIM банк на 512 портов и только 64 GSM-модуля в оборудовании, Вам необходимо вернуть 64 номера, а не 512. Нарушение этого условия повлечет автоматическую блокировку системой выдачу Ваших номеров на 30 минут.

ВАЖНО! Включение параметра rent (присваиванием ему значения 1) позволяет клиентам арендовать Ваши номера на длительный период, значительно увеличивая Ваш доход. Однако Вам необходимо связаться с партнерской поддержкой для получиения подробной информации об условиях и требованиях к арендным номерам, перед тем, как мы включим этот функционал на Вашем аккаунте.

Серверы

https://{ourserver.com}

Parameters

Authorization
Обязательный

Смотрите подробнее тут

В: header
Схема:
  • string
    Пример: "Bearer apikey"

Тело запроса

Ваш сервер должен посылать данный запрос каждые 5 минут в качестве подверждения аптайма, либо при изменении списка доступных номеров (при добавлении новых номеров или удалении каких-либо, ранее переданных).
Тип содержимого:
application/json
  • Schema
  • Examples
  • object
    Пример: {"numbers":[{"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}],"test":"test1"}
    Свойства:
    • numbers
      array
      Пример: [{"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}]
      Items:
      • object
        Пример: {"number":"+46050910804","country_id":46,"operator":24012,"date_start":1658209063,"port_id":"Port1","rent":0}
    • test
      string
      Параметр для тестов. Может принимать одно из двух значений: `test1` или `test2`. Будучи равным `test1` отправит запрос на сервер, но данные, переданные таким запросом не будут сохранены нашим сервером (не вызовет исполнения функции). Если параметр будет равен `test2`, то сервер Onlinesim в ответе вернет тело Вашего запроса.
      Пример: "test1"
      Перечисление: test1 test2

Ответы

200

Ответ сервера Onlinesim
Тип содержимого:
application/json
  • Schema
  • Examples
  • object
    Пример: {"response":1,"ids":{"#number#":0}}
    Свойства:
    • response
      mixed
      1, если запрос был выполнен успешно, либо выведет сообщение об ошибке
      Пример: 1
      Одно из:
      • string
        Пример: "string"
      • integer
        Пример: 0
    • ids
      object
      Пример: {"#number#":0}

400

Ошибка 400
Тип содержимого:
text/html
  • Schema
  • Examples
  • string
    Описание ошибки
    Пример: "string"