post sendNumbersOnline

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

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

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

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

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

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

Серверы

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`. &br; Будучи равным `test1` отправит запрос на сервер, но данные, переданные таким запросом не будут сохранены нашим сервером (не вызовет исполнения функции). &br; Если параметр будет равен `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"