Cheap-SMS.com - Документация 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 | 57.00 |
2 |
![]() |
ok | 12.00 |
3 |
![]() |
vi | 10.00 |
4 |
![]() |
tg | 170.00 |
5 |
![]() |
wb | 15.00 |
6 |
![]() |
go | 10.00 |
8 |
![]() |
fb | 5.00 |
10 |
![]() |
ub | 6.00 |
13 |
![]() |
ig | 8.00 |
16 |
![]() |
ma | 30.00 |
17 |
![]() |
mm | 6.00 |
18 |
![]() |
mb | 3.00 |
19 |
![]() |
we | 5.00 |
20 |
![]() |
bd | 15.00 |
21 |
![]() |
ya | 30.00 |
22 |
![]() |
mt | 15.00 |
23 |
![]() |
oi | 8.00 |
24 |
![]() |
fd | 10.00 |
25 |
![]() |
pm | 6.00 |
26 |
![]() |
ot | 42.00 |
27 |
![]() |
qw | 30.00 |
28 |
![]() |
oy | 7.00 |
30 |
![]() |
wm | 10.00 |
31 |
![]() |
fs | 7.00 |
32 |
![]() |
cp | 200.00 |
36 |
![]() |
sp | 3.00 |
37 |
![]() |
wp | 190.00 |
39 |
![]() |
dd | 3.00 |
43 |
![]() |
dc | 5.00 |
44 |
![]() |
dt | 30.00 |
45 |
![]() |
rn | 7.00 |
46 |
![]() |
ln | 3.00 |
47 |
![]() |
mn | 5.00 |
48 |
|
1c | 33.00 |
53 |
![]() |
tt | 7.00 |
54 |
![]() |
mk | 100.00 |
56 |
![]() |
gl | 5.00 |
57 |
![]() |
bb | 50.00 |
58 |
![]() |
cm | 10.00 |
59 |
![]() |
zc | 10.00 |
61 |
![]() |
tv | 1.00 |
62 |
![]() |
rs | 10.00 |
63 |
![]() |
md | 3.00 |
64 |
![]() |
pr | 5.00 |
66 |
![]() |
wl | 48.00 |
67 |
![]() |
pc | 15.00 |
68 |
![]() |
bt | 3.00 |
69 |
![]() |
zy | 50.00 |
70 |
![]() |
rb | 99.00 |
71 |
![]() |
tf | 35.00 |
77 |
![]() |
bz | 5.00 |
78 |
![]() |
gp | 10.00 |
79 |
![]() |
gr | 2.00 |
80 |
![]() |
dm | 8.00 |
81 |
![]() |
di | 3.00 |
83 |
![]() |
yg | 80.00 |
84 |
![]() |
pg | 10.00 |
85 |
![]() |
in | 6.00 |
86 |
![]() |
vr | 15.00 |
87 |
![]() |
am | 1.00 |
88 |
![]() |
yo | 30.00 |
89 |
![]() |
sa | 10.00 |
90 |
![]() |
oz | 20.00 |
91 |
![]() |
me | 50.00 |
93 |
![]() |
fc | 3.00 |
94 |
![]() |
ko | 5.00 |
96 |
![]() |
ic | 5.00 |
97 |
![]() |
vv | 5.00 |
98 |
![]() |
wh | 30.00 |
99 |
![]() |
al | 3.00 |
101 |
![]() |
ke | 30.00 |
103 |
![]() |
pp | 10.00 |
104 |
![]() |
ea | 10.00 |
105 |
![]() |
bc | 15.00 |
107 |
![]() |
tc | 2.00 |
108 |
![]() |
kf | 7.00 |
109 |
![]() |
ur | 10.00 |
110 |
![]() |
ce | 500.00 |
111 |
![]() |
dn | 100.00 |
112 |
![]() |
xg | 15.00 |
113 |
![]() |
ai | 3.00 |
115 |
![]() |
hr | 5.00 |
116 |
![]() |
vd | 30.00 |
117 |
![]() |
px | 10.00 |
118 |
![]() |
si | 50.00 |
119 |
![]() |
af | 280.00 |
121 |
![]() |
ml | 10.00 |
122 |
![]() |
mh | 7.00 |
124 |
![]() |
ca | 45.00 |
125 |
![]() |
ut | 10.00 |
127 |
![]() |
ap | 10.00 |
128 |
![]() |
kp | 50.00 |
129 |
![]() |
ps | 35.00 |
130 |
![]() |
gb | 15.00 |
131 |
![]() |
pb | 30.00 |
133 |
![]() |
ek | 50.00 |
134 |
![]() |
sv | 15.00 |
135 |
![]() |
bankiru | 100.00 |
136 |
![]() |
mts_id | 100.00 |
- Проблемы? @CHEAPSMS_HELPER
- Скучно? @cheapsmschat
- Когда пополнение? @cheapsms