Skip to content

POST /finishActivation

Завершить текущую операцию приема

Данный запрос отправляется сервером Onlinesim для закрытия текущей операции с определенным статусом (который зависит от результатов операции).

По умолчанию данный запрос отправляется по истечению времени операции (15 минут для услуги "Прием SMS"). Запрос также может быть отправлен досрочно в одном из двух случаев:

  1. если SMS от заказанного сервиса было успешно получено и клиент закрывает операцию самостоятельно;
  2. если SMS от заказанного сервиса не было получено и клиент отменяет операцию.

WARNING

Ваш сервер должен прислать ответ об успешном закрытии операции в течение 10 секунд после получения запроса. Если по истечению этого времени ответа не последует, текущий запрос автоматически отменяется (направляется новый запрос на закрытие).

DANGER

Пожалуйста, не закрывайте операции на своей стороне до получения от нас запроса FINISH_ACTIVATION. Самостоятельное закрытие операций может привести к рассинхронизации статусов и некорректной обработке последующих запросов.

Окончание
операции

Параметры

НазваниеТипОписание
Authorization*string

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

Пример:Bearer apikey

Тело запроса

Тело запроса от сервера Onlinesim

Content-Type:application/json
Bodyobject
actionstringОбязательный

Имя метода, в данном случае FINISH_ACTIVATION

Перечисление:FINISH_ACTIVATION
По умолчанию:FINISH_ACTIVATION
Пример:FINISH_ACTIVATION
activationIdintegerОбязательный

ID операции (присваивается Вашим сервером)

≥ 1
Пример:355
sumnumber

Сумма, зачисленная на баланс партнера, за оказанную услугу
(в рублях)

Пример:4.5
statusintegerОбязательный

Код статуса операции, enum:

1 - Номер не был заказан под указанный тип услуги
(например, Вы пытатесь отправить сообщение для услуги
“Прием”, когда номер заказан для “Аренда”)

3 - Операция завершена успешно

4 - Операция была отменена, сообщение не было получено

5 - По операции был совершен возврат, в случае ошибок и
проблем с сообщением.

Перечисление:1345
Пример:3
keystringОбязательный

API ключ Вашего профиля партнера Onlinesim

Ответы

200

Ответ Вашего сервера на запрос FINISH_ACTIVATION должен быть в
следующем формате:

Примеры кода