CheapSMS.io - Документация 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 37.00
2 Одноклассники ok 33.00
3 Viber vi 7.00
4 Telegram tg 110.00
5 WeChat wb 6.00
6 Google, Gmail go 6.00
8 Facebook fb 5.00
9 Twitter tw 3.00
10 Uber ub 6.00
11 Gett gt 3.00
13 Instagram ig 1.00
14 SeoSprint ss 3.00
16 Mail.ru ma 33.00
17 Microsoft mm 6.00
18 Yahoo mb 3.00
19 ДругВокруг we 5.00
20 Rambler bd 3.00
21 Yandex ya 10.00
22 Steam mt 5.00
23 Tinder oi 8.00
24 Mamba fd 7.00
25 AOL pm 6.00
26 Нет в списке ot 38.00
27 Qiwi qw 3.00
28 Okey oy 3.00
29 Steemit sm 3.00
30 WebMoney wm 10.00
31 Фотострана fs 3.00
32 CreditPlus cp 30.00
36 Спортмастер sp 3.00
37 WhatsApp wp 270.00
39 DodoPizza dd 3.00
43 Discord dc 5.00
44 Delivery Club dt 25.00
45 Роснефть rn 7.00
46 Лента ln 3.00
47 Магнит mn 5.00
48 Ецупис 1c 33.00
49 Pandao pd 3.00
51 IMO im 3.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
65 Nike nk 10.00
66 Wildberries wl 5.00
67 РСА pc 6.00
68 Beget bt 3.00
69 Zaymer zy 50.00
70 Rocketbank rb 99.00
71 Tinkoff tf 30.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 10.00
84 PGbonus pg 10.00
85 Linkedin in 6.00
86 Любимый Врач vr 15.00
87 Amazon am 1.00
88 YooMoney yo 12.00
89 Samokat sa 10.00
90 OZON oz 30.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 15.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
110 CONTACT ce 10.00
111 MTS BANK dn 70.00
112 X5 Group xg 6.00
113 Alibaba ai 3.00
115 Hohoro hr 5.00
116 VIVADENGI vd 30.00
117 Piastrix px 10.00
118 SberID si 130.00
119 AlfaBank af 50.00
121 Marlboro ml 10.00
122 MVideo mh 7.00
123 Book24 bk 3.00
124 Принять звонок ca 20.00
125 Uteka ut 10.00
126 Centrify cn 3.00
127 Apple ap 3.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 60.00