Cheap-SMS.com - Документация API
Обновление номеров
Документация API для
автоматизации
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
Параметры:
$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
Параметры:
$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
Параметры:
$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
Примечание:
Сервис остается тот же
Цена -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 - статусы активации:
Ответ сервиса:
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
Параметры:
$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
Параметры:
$api_key = ВАШ_API_KEY
$id - id активации
Ответ сервиса:
STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:$lastcode - ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
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 | wb | 18.00 | |
6 | Google, Gmail | go | 15.00 |
8 | fb | 5.00 | |
10 | Uber | ub | 6.00 |
13 | 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 | 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 | 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 |
- Проблемы? @CHEAPSMS_HELPER
- Скучно? @cheapsmschat
- Когда пополнение? @cheapsms