API - это протокол взаимодействия между вашим ПО и нашим сервисом активаций. Он необходим для автоматизации процесса получения СМС на вашей стороне.
Все запросы (только GET) должны идти на данный адрес:
https://365api.net/stubs/handler_api.php

Запрос количества доступных номеров

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	API-ключ обеспечивает доступ к оплаченным услугам
COUNTRY	См. список стран в левом меню	Да	Страна номера
OPERATOR	См. список операторов в левом меню	Нет	Оператор номера. Если параметр не задан, будет задействован случайный оператор

Ответ сервиса будет в json формате, пример:
{"vk_0":890,"ok_0":192,"wa_0":146,"vi_0":199,"tg_0":101,"wb_0":103,"go_0":467,"av_0":177,"fb_0":132,"tw_0":479}

Запрос баланса

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=getBalance

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	API-ключ обеспечивает доступ к оплаченным услугам

 

Выходные данные

Ответ сервера	Пример	Описание
ACCESS_BALANCE:BALANCE	ACCESS_BALANCE:540	BALANCE - баланс вашего акаунта

 

Возможные ошибки

Ответ сервера	Описание
BAD_KEY	Неверный API-ключ
ERROR_SQL	Ошибка SQL-сервера
BAD_ACTION	Неправильное формирование запроса

Заказ номера

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	API-ключ обеспечивает доступ к оплаченным услугам
SERVICE	См. список сервисов в левом меню	Да	Сервис, номер для которого необходимо получить
OPERATOR	Принимаемые параметры зависят от конкретной страны. Для уточнения обратите внимание на список операторов в левом меню	Нет	Сотовый оператор, номер которого необходимо получить
COUNTRY	См. список стран в левом меню	Да	Страна, номер которой необходимо получить

 

Ответы сервиса

Ответ сервера	Пример	Описание
NO_NUMBERS	NO_NUMBERS	Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну
NO_BALANCE	NO_BALANCE	Закончились деньги на аккаунте
WRONG_SERVICE	WRONG_SERVICE	Неверный идентификатор сервиса
ACCESS_NUMBER:ID:NUMBER	ACCESS_NUMBER:234242:79123456789	Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER

 

Возможные ошибки

Ответ сервера	Описание
BAD_ACTION	Неправильное формирование запроса
BAD_SERVICE	Некорректное наименование сервиса
BAD_KEY	Неверный API-ключ
ERROR_SQL	Ошибка базы SQL-сервера

Изменить статус

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	Ваш API-ключ обеспечивает доступ к оплаченным услугам
ID	Числовое значение	Да	ID активации, полученное при запросе номера
STATUS	3 - необходимо повторно смс, 6 - активация успешно завершена, 8 - отменить активацию	Да	Статус который необходимо передать номеру

Какой статус когда отправлять?

Сразу после получения номера, номер находится в ожидании SMS.
Вам доступны следующие действия:
8 - Отменить активацию

Сразу после получения кода:
3 - Запросить еще одну смс
6 - Подтвердить SMS-код и завершить активацию

Для активации со статусом 3:
6 - Подтвердить SMS-код и завершить активацию

Выходные данные

Ответ сервера	Описание
STATUS_WAIT_CODE	Ожидаем прихода СМС
ACCESS_ACTIVATION	Активация успешно завершена
ACCESS_CANCEL	Активация отменена

 

Возможные ошибки

Ответ сервера	Описание
BAD_ACTION	Общее неправильное формирование запроса
BAD_SERVICE	Некорректное наименование сервиса
BAD_KEY	Неверный API-ключ
NO_ACTIVATION	ID активации не существует
ERROR_SQL	Ошибка базы SQL-сервера, обратитесь к администратору

Получить статус

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	API-ключ обеспечивает доступ к оплаченным услугам
ID	Числовое значение	Да	ID активации, полученное при запросе номера

 

Выходные данные

Ответ сервера	Описание
STATUS_WAIT_CODE	Ожидаем прихода СМС
STATUS_CANCEL	Активация отменена
STATUS_OK:CODE	Код получен (где CODE - код активации)

 

Возможные ошибки

Ответ сервера	Описание
BAD_ACTION	Общее неправильное формирование запроса
BAD_KEY	Неверный API-ключ
NO_ACTIVATION	ID активации не существует
ERROR_SQL	Ошибка базы SQL-сервера. Обратитесь к администратору

Запросить все цены

https://365api.net/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	yo3bPrzepLDAgcU7bFwfvmrvYalMGA	Да	API-ключ обеспечивает доступ к оплаченным услугам
SERVICE	См. список сервисов в левом меню	Нет	Сервис, номер для которого необходимо получить
COUNTRY	См. список стран в левом меню	Да	Страна номера

 

Выходные данные

Ответ сервера	Описание
JSON ответ	Ответ в формате { "Страна": { "Сервис": { "Цена": Количество}}}