CheapSMS.xyz - Документация API


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

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

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

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

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

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

https://cheapsms.xyz/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

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

Ответ сервиса в json формате:
{"vk":"0","ig":"3","ok":"1","vi":"3","other":"2"}

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

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

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

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

Пример:
https://cheapsms.xyz/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getBalance
https://cheapsms.xyz/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=vk&ref=$ref

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

Список доступных сервисов vk - Вконтакте, ig - Инстаграмм, ok - Одноклассники, vi - Вайбер, other - Другие сервисы

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

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

Пример:
https://cheapsms.xyz/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getNumber&service=vk
https://cheapsms.xyz/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-сервера

Пример:
https://cheapsms.xyz/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=getNumber&service=vk
https://cheapsms.xyz/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-сервера

Пример:
https://cheapsms.xyz/stubs/handler_api.php?api_key=f8d597bb7439df66a4eeb5befdee6e44&action=setStatus&status=1&id=1
https://cheapsms.xyz/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-сервера

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