API документация сервиса sms-man
API - это протокол взаимодействия между вашим ПО и нашим сервером активаций. API нужен для того, чтобы автоматизировать процесс получение смс сообщений на вашей стороне Для работы с API необходимо использовать ваш API ключ, получить его можно у менеджера Наше API полностью совместимо с сайтами конкурентов
Описание протокола API
- Все запросы должны идти на http://api.sms-man.ru/stubs/handler_api.php
- POST или GET запросом.
- Во всех запросах должен присутствовать API ключ в виде параметра "api_key"
Запрос количества доступных номеров:
- http://api.sms-man.ru/stubs/handler_api.php?api_key=$api_key&action=getPrices&country=$country
- $ api_key - API key
- $ country - страна номера смотрите таблицу
- Ответ сервиса будет в json формате. Пример:
{"0":{"vk":{"cost":15,"count":6455},"wb":{"cost":50,"count":124}}, "1":{"fb":{"cost":6,"count":1000},"tw":{"cost":6,"count":1000}}}
Запрос баланса:
- http://api.sms-man.ru/stubs/handler_api.php?api_key=$api_key&action=getBalance
- $ api_key - API key
- Ответ сервиса:
- ACCESS_BALANCE:$balance (где $balance - баланс на счету)
- Возможные ошибки:
- BAD_KEY - Неверный API-ключ
Заказ номера:
- http://api.sms-man.ru/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country
- $ api_key - API key
- $ service - сервис для заказа смотрите таблицу
- $ country - страна номера смотрите таблицу
- $ ref - Передать реферальный идентификатор, подробнее.
- Ответ сервиса:
- ACCESS_NUMBER:$id:$number - номер выдан ($id - id операции,$number - номер телефона)
- Возможные ошибки:
- BAD_KEY - Неверный API-ключ
- NO NUMBERS - Нет номеров, попробуйте позднее
- NO_BALANCE - Низкий баланс
Получить состояние активации:
- http://api.sms-man.ru/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 - ожидание уточнения кода (где - прошлый, неподошедший код)
- STATUS_WAIT_RESEND - ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
- STATUS_CANCEL - активация отменена
- STATUS_OK:$code - код получен (где $code - код активации)
- Возможные ошибки:
- BAD_KEY - Неверный API-ключ
- NO_ACTIVATION - id активации не существует
Изменение статуса активации:
- http://api.sms-man.ru/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
- $ api_key - API key
- $ id - id активации
- $status - статус активации:
- Ответ сервиса:
- ACCESS_READY - готовность номера подтверждена
- ACCESS_RETRY_GET - ожидание нового смс
- ACCESS_ACTIVATION - сервис успешно активирован
- ACCESS_CANCEL - активация отменена
- Возможные статусы:
- -1 - отменить активацию
- 1 - сообщить о готовности номера (смс на номер отправлено)
- 3 - запросить еще один код (бесплатно)
- 6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает, если был "подготовка" - удаляет и помечает ошибка, если был статус "ожидает повтора" - переводит активацию в ожидание смс)
- 8 - сообщить о том, что номер использован и отменить активацию
- Возможные ошибки:
- BAD_KEY - Неверный API-ключ
- NO_ACTIVATION - id активации не существует
API аренды
List of countries:
Номер страны | Страна |
---|---|
0 | ![]() |
2 | ![]() |
3 | ![]() |
1 | ![]() |
187 | ![]() |
7 | ![]() |
6 | ![]() |
4 | ![]() |
5 | ![]() |
10 | ![]() |
32 | ![]() |
15 | ![]() |
36 | ![]() |
22 | ![]() |
147 | ![]() |
66 | ![]() |
60 | ![]() |
54 | ![]() |
24 | ![]() |
90 | ![]() |
8 | ![]() |
11 | ![]() |
13 | ![]() |
14 | ![]() |
16 | ![]() |
17 | ![]() |
150 | ![]() |
19 | ![]() |
20 | ![]() |
21 | ![]() |
23 | ![]() |
25 | ![]() |
26 | ![]() |
27 | ![]() |
28 | ![]() |
29 | ![]() |
30 | ![]() |
31 | ![]() |
33 | ![]() |
34 | ![]() |
35 | ![]() |
37 | ![]() |
38 | ![]() |
39 | ![]() |
40 | ![]() |
41 | ![]() |
42 | ![]() |
43 | ![]() |
44 | ![]() |
45 | ![]() |
46 | ![]() |
47 | ![]() |
48 | ![]() |
49 | ![]() |
50 | ![]() |
51 | ![]() |
52 | ![]() |
53 | ![]() |
55 | ![]() |
56 | ![]() |
57 | ![]() |
58 | ![]() |
59 | ![]() |
61 | ![]() |
62 | ![]() |
63 | ![]() |
64 | ![]() |
65 | ![]() |
67 | ![]() |
68 | ![]() |
69 | ![]() |
70 | ![]() |
71 | ![]() |
72 | ![]() |
73 | ![]() |
74 | ![]() |
75 | ![]() |
76 | ![]() |
77 | ![]() |
78 | ![]() |
79 | ![]() |
80 | ![]() |
81 | ![]() |
82 | ![]() |
83 | ![]() |
84 | ![]() |
85 | ![]() |
86 | ![]() |
87 | ![]() |
88 | ![]() |
89 | ![]() |
149 | ![]() |
91 | ![]() |
92 | ![]() |
93 | ![]() |
94 | ![]() |
95 | ![]() |
96 | ![]() |
97 | ![]() |
98 | ![]() |
99 | ![]() |
18 | ![]() |
155 | ![]() |
181 | ![]() |
169 | ![]() |
148 | ![]() |
179 | ![]() |
175 | ![]() |
122 | ![]() |
145 | ![]() |
118 | ![]() |
124 | ![]() |
120 | ![]() |
158 | ![]() |
108 | ![]() |
123 | ![]() |
152 | ![]() |
119 | ![]() |
186 | ![]() |
170 | ![]() |
125 | ![]() |
151 | ![]() |
133 | ![]() |
113 | ![]() |
168 | ![]() |
126 | ![]() |
109 | ![]() |
105 | ![]() |
101 | ![]() |
167 | ![]() |
176 | ![]() |
163 | ![]() |
162 | ![]() |
154 | ![]() |
128 | ![]() |
129 | ![]() |
127 | ![]() |
160 | ![]() |
130 | ![]() |
131 | ![]() |
132 | ![]() |
103 | ![]() |
182 | ![]() |
116 | ![]() |
100 | ![]() |
153 | ![]() |
136 | ![]() |
135 | ![]() |
165 | ![]() |
137 | ![]() |
159 | ![]() |
114 | ![]() |
157 | ![]() |
144 | ![]() |
171 | ![]() |
180 | ![]() |
138 | ![]() |
185 | ![]() |
139 | ![]() |
174 | ![]() |
107 | ![]() |
117 | ![]() |
111 | ![]() |
140 | ![]() |
184 | ![]() |
141 | ![]() |
142 | ![]() |
173 | ![]() |
143 | ![]() |
104 | ![]() |
161 | ![]() |
156 | ![]() |
121 | ![]() |
102 | ![]() |
183 | ![]() |
134 | ![]() |
164 | ![]() |
166 | ![]() |
178 | ![]() |
110 | ![]() |
9 | ![]() |
106 | ![]() |
112 | ![]() |
115 | ![]() |
146 | ![]() |
177 | ![]() |
List of services:
Service code | Сервис |
---|---|
vk | ![]() |
wb | ![]() |
tg | ![]() |
ok | ![]() |
ig | ![]() |
wa | ![]() |
vi | ![]() |
go | ![]() |
av | ![]() |
fb | ![]() |
tw | ![]() |
ub | ![]() |
qw | ![]() |
gt | ![]() |
sn | ![]() |
ss | ![]() |
ym | ![]() |
ma | ![]() |
mm | ![]() |
uk | ![]() |
me | ![]() |
mb | ![]() |
we | ![]() |
bd | ![]() |
kp | ![]() |
dt | ![]() |
ya | ![]() |
mt | ![]() |
oi | ![]() |
fd | ![]() |
zz | ![]() |
kt | ![]() |
pm | ![]() |
tn | ![]() |
![]() | |
mg | ![]() |
pf | ![]() |
yl | ![]() |
kl | ![]() |
po | ![]() |
nv | ![]() |
nf | ![]() |
iq | ![]() |
ob | ![]() |
kb | ![]() |
im | ![]() |
mc | ![]() |
ds | ![]() |
vv | ![]() |
ji | ![]() |
lf | ![]() |
hu | ![]() |
wg | ![]() |
rz | ![]() |
vf | ![]() |
ny | ![]() |
rr | ![]() |
fe | ![]() |
la | ![]() |
gp | ![]() |
am | ![]() |
ly | ![]() |
tc | ![]() |
dp | ![]() |
pg | ![]() |
yf | ![]() |
op | ![]() |
fx | ![]() |
qr | ![]() |
yk | ![]() |
ls | ![]() |
bl | ![]() |
mu | ![]() |
fu | ![]() |
bf | ![]() |
sg | ![]() |
uu | ![]() |
ua | ![]() |
ab | ![]() |
iv | ![]() |
zy | ![]() |
gd | ![]() |
fy | ![]() |
ce | ![]() |
tl | ![]() |
hm | ![]() |
tx | ![]() |
ka | ![]() |
pl | ![]() |
ip | ![]() |
cm | ![]() |
hw | ![]() |
de | ![]() |
jc | ![]() |
rl | ![]() |
df | ![]() |
ui | ![]() |
up | ![]() |
nz | ![]() |
kf | ![]() |
ri | ![]() |
cc | ![]() |
lr | ![]() |
za | ![]() |
da | ![]() |
ug | ![]() |
sq | ![]() |
zr | ![]() |
xv | ![]() |
cx | ![]() |
cw | ![]() |
li | ![]() |
dz | ![]() |
xz | ![]() |
rd | ![]() |
qb | ![]() |
hz | ![]() |
gl | ![]() |
zk | ![]() |
ht | ![]() |
ts | ![]() |
re | ![]() |
wc | ![]() |
dh | ![]() |
ew | ![]() |
dn | ![]() |
pu | ![]() |
fj | ![]() |
zm | ![]() |
zh | ![]() |
gx | ![]() |
sf | ![]() |
wf | ![]() |
bz | ![]() |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
cq | ![]() |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
rt | ![]() |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
uz | ![]() |
yw | ![]() |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() | |
![]() |