Cheap-SMS.com - Документация API


API - это протокол взаимодействия между вашим ПО и нашим сервером активаций.

API нужен для того, чтобы автоматизировать процесс получение смс сообщений на вашей стороне

Доступные интеграции: Sms-Activate

Все запросы должны идти на https://cheapsms.pro/handler/index

POST или GET запросом.

Во всех запросах должен присутствовать API ключ в виде параметра "api_key"

http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Параметры:
$api_key = ВАШ_API_KEY
$country = параметр не играет роли

Ответ сервиса в json формате:
{"vk_0":"0","ig_0":"3","ok_0":"1","vi_0":"3","other_0":"2"}

Где до черточки - название сервиса, после обозначение нужно ли включать переадресацию. 0 - не включать. 1 - включать. Переадресации пока нет
Возможные ошибки:
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getNumbersStatus&country=$country
http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=getBalance

Параметры:
$api_key = ВАШ_API_KEY

Ответ сервиса:
ACCESS_BALANCE:$balance (где $balance - баланс на счету)
Возможные ошибки:
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getBalance
http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=vk_0&ref=$ref

Параметры:
$api_key = ВАШ_API_KEY
$service - сервис для заказа $ref - Логин

Список доступных сервисов vk_0 - Вконтакте, ig_0 - Инстаграмм, ok_0 - Одноклассники, vi_0 - Вайбер, other_0 - Другие сервисы

Ответ сервиса:
NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number - номер выдан ($id - id операции,$number - номер телефона)

Возможные ошибки:
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getNumber&service=vk_0
http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=retryNumber&id=$id

Примечание:
Сервис остается тот же
Цена -50% от старого заказа
При отмене деньги не возвращаться


Параметры:
$api_key = ВАШ_API_KEY
$id - номер старой операции который нужно повторить

Ответ сервиса:
NUMBER_OFFLINE - сим-карта не онлайн
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number - номер выдан ($id - id операции,$number - номер телефона)

Возможные ошибки:
ORDER_NOT_FOUND - номер старой операции не найден
IMPOSSIBLE_AGAIN - невозможно повторить этот заказ
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getNumber&service=vk_0
http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Параметры:
$api_key = ВАШ_API_KEY
$id - id активации
$status - статусы активации:
  • -1 - отменить активацию
  • 1 - сообщить о готовности номера (смс на номер отправлено)
  • 3 - запросить еще один код (бесплатно)
  • 6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает

Ответ сервиса:
ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена
ACCESS_COMPLETED - активация использована

Возможные ошибки:
NO_ACTIVATION - id активации не существует
BAD_SERVICE - некорректное наименование сервиса
BAD_STATUS - некорректный статус
BAD_KEY - Неверный API-ключ
BAD_ACTION - некорректное действие
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=setStatus&status=1&id=1
http://cheapsms.pro/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Параметры:
$api_key = ВАШ_API_KEY
$id - id активации

Ответ сервиса:
STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:$lastcode - ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
STATUS_WAIT_RESEND - ожидание повторной отправки смс
STATUS_CANCEL - активация отменена
STATUS_OK:$code - код получен (где $code - код активации)

Возможные ошибки:
NO_ACTIVATION - id активации не существует
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Пример:
http://cheapsms.pro/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getStatus&id=1
# Название Код Цена
1 ВКонтакте vk 70.00
2 Одноклассники ok 15.00
3 Viber vi 37.00
4 Telegram tg 150.00
5 WeChat wb 18.00
6 Google, Gmail go 15.00
8 Facebook fb 5.00
10 Uber ub 6.00
13 Instagram ig 5.00
16 Mail.ru ma 30.00
17 Microsoft mm 6.00
18 Yahoo mb 3.00
19 ДругВокруг we 5.00
20 Rambler bd 15.00
21 Yandex ya 25.00
22 Steam mt 15.00
23 Tinder oi 8.00
24 Mamba fd 7.00
25 AOL pm 6.00
26 Нет в списке ot 70.00
27 Qiwi qw 30.00
28 Okey oy 7.00
30 WebMoney wm 10.00
31 Фотострана fs 7.00
36 Спортмастер sp 3.00
37 WhatsApp wp 100.00
39 DodoPizza dd 3.00
43 Discord dc 5.00
44 Delivery Club dt 10.00
45 Роснефть rn 7.00
46 Лента ln 3.00
47 Магнит mn 5.00
48 Ецупис 1c 47.00
53 TikTok tt 7.00
54 MicroKlad mk 35.00
56 Глобус gl 5.00
57 BlaBlaCar bb 50.00
58 СитиМобиль cm 10.00
59 ЗДРАВСИТИ zc 1.00
61 Tradingview tv 1.00
62 RESO rs 10.00
63 Вкусно и точка md 3.00
64 Почта России pr 5.00
66 Wildberries wl 30.00
67 РСА pc 20.00
68 Beget bt 3.00
69 Zaymer zy 50.00
70 Rocketbank rb 99.00
71 Tinkoff tf 35.00
77 Benzuber bz 5.00
78 GPNbonus gp 10.00
79 Grindr gr 2.00
80 Детский мир dm 8.00
81 DiDi di 3.00
83 YandexGo yg 20.00
84 PGbonus pg 10.00
85 Linkedin in 6.00
86 Любимый Врач vr 15.00
88 YooMoney yo 20.00
89 Samokat sa 10.00
90 OZON oz 20.00
91 MegafonTV me 50.00
93 FACEIT fc 3.00
94 Okko ko 5.00
96 ICQ ic 5.00
97 Vkusvill vv 5.00
98 Whoosh wh 30.00
99 Aliexpess al 3.00
101 KazanExpress ke 10.00
103 PayPal pp 10.00
105 Blockchain bc 15.00
107 Twitch tc 2.00
108 KFC kf 7.00
109 Urent ur 10.00
111 MTS BANK dn 60.00
112 X5 Group xg 8.00
113 Alibaba ai 3.00
115 Hohoro hr 5.00
116 VIVADENGI vd 30.00
117 Piastrix px 10.00
118 SberID / Купер si 50.00
119 AlfaBank af 50.00
121 Marlboro ml 10.00
122 MVideo mh 7.00
124 Принять звонок ca 57.00
125 Uteka ut 10.00
127 Apple ap 10.00
128 KoronaPay kp 50.00
129 Salampay ps 35.00
130 Gazprombank gb 15.00
131 POCHTABANK pb 30.00
133 Ekapusta ek 50.00
134 Совкомбанк sv 15.00
135 Banki.ru bankiru 50.00
136 МТС ID mts_id 50.00