Hướng dẫn API tích hợp
Hướng dẫn chi tiết về cách làm việc với API và các ví dụ về tích hợp với trang web 'Tiger SMS'. Tất cả dữ liệu cần thiết để tích hợp hiệu quả với dịch vụ 'Tiger SMS' và nhận SMS ở chế độ tự động.
API của chúng tôi hoàn toàn tương thích với các trang web cạnh tranh
Tất cả các yêu cầu nên được gửi đến
https://api.tiger-sms.com/stubs/handler_api.php
Yêu cầu POST hoặc GET
Tất cả các yêu cầu phải có một khóa API dưới định dạng 'api_key'
Vui lòng giảm số lượng yêu cầu đồng thời (luồng) từ phía bạn - điều này sẽ giúp cải thiện ổn định và tăng cơ hội nhận được số điện thoại.
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance
$api_key - Khóa API của bạn
Trả lời:ACCESS_BALANCE: Số dư tài khoản
Các lỗi có thể xảy ra:BAD_KEY - khóa API không hợp lệ
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref
$api_key - Khóa API của bạn
$service - dịch vụ Tham khảo bảng
$country - số quốc gia Tham khảo bảng
$ref - Mã giới thiệu
$maxPrice - Giá tối đa mà bạn sẵn sàng trả để mua số điện thoại (tính bằng đô la)
$providerIds - Danh sách ID của nhà cung cấp mà bạn cần mua, được phân tách bằng dấu phẩy (1,2,3).
$exceptProviderIds - Danh sách ID của nhà cung cấp không cần sử dụng khi mua, được phân tách bằng dấu phẩy (4,5,6).
$activationType - Loại kích hoạt. Các giá trị có thể: SMS (kích hoạt qua SMS), CALL_FLASH (kích hoạt bằng cuộc gọi), CALL_VOICE (kích hoạt bằng cuộc gọi thoại), CALL_INTERACTIVE (kích hoạt bằng cuộc gọi thoại với hành động), RENT_SMS (thuê số cho SMS)
*Tham số tùy chọn.:Trong yêu cầu, bạn có thể sử dụng providerIds hoặc exceptProviderIds. Bạn có thể chỉ định một hoặc nhiều nhà cung cấp, cách nhau bằng dấu phẩy.
Bằng cách nhận số thông qua API, bạn đồng ý với các quy tắc của dự án.
Trả lời:ACCESS_NUMBER:'id kích hoạt':'số điện thoại'
CÓ THỂ CÓ LỖI:BAD_ACTION - hành động không chính xác
BAD_SERVICE - Tên dịch vụ không chính xác
BAD_COUNTRY - Mã quốc gia không chính xác
BAD_MULTIPLE - giá trị tham số multiple không hợp lệ
BAD_MAX_PRICE - giá trị tham số maxPrice không hợp lệ
BAD_KEY - khóa API không hợp lệ
BAD_REF - Id giới thiệu không hợp lệ
NO_NUMBERS - không có số
NO_BALANCE - số dư không đủ
BAD_VALUES - giá trị tham số không hợp lệ
Too Many Requests (429) - Quá nhiều yêu cầu
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
$api_key - Khóa API của bạn
$id - Kích hoạt ID
Trả lời:STATUS_WAIT_CODE - Chờ tin nhắn SMS
STATUS_WAIT_RETRY - Đang chờ tin nhắn tiếp theo
ACCESS_CANCEL - Kích hoạt đã bị hủy
STATUS_OK: Mã kích hoạt - đã nhận
CÓ THỂ CÓ LỖI:BAD_KEY - khóa API không hợp lệ
BAD_ACTION - hành động không chính xác
NO_ACTIVATION - Sai mã kích hoạt
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
$api_key - Khóa API của bạn
$id - Kích hoạt ID
$status - Trạng thái kích hoạt
- 1 - thông báo về tình trạng sử dụng của số điện thoại (SMS đã được gửi đến số điện thoại)
- 3 - yêu cầu mã khác (miễn phí)
- 6 - hoàn tất kích hoạt *
- 8 - thông báo rằng số đã được sử dụng và hủy kích hoạt
Ở trạng thái 'code đã nhận' - đánh dấu thành công và hoàn tất, ở trạng thái 'chuẩn bị' - xóa và đánh dấu lỗi, ở trạng thái 'đang chờ thử lại' - chuyển kích hoạt sang SMS đang chờ.
Không thể thay đổi trạng thái kích hoạt nếu phương pháp xác minh bằng cuộc gọi đã được chọn nếu số điện thoại đã được gửi
Logic đơn giản về thời gian lịch API:
Lấy số bằng phương thức getNumber sau đó làm theo các bước sau:
- 8 - Hủy bỏ kích hoạt (nếu số không khớp với bạn)
- 1 - Báo cáo rằng tin nhắn đã được gửi (tùy chọn)
- Kích hoạt với trạng thái 1:
- 8 - Hủy kích hoạt Ngay sau khi nhận được mã code:
- 3 - Yêu cầu một SMS khác
- 6 - Xác nhận mã SMS và hoàn tất kích hoạt
- Để kích hoạt với trạng thái 3:
- 6 - Xác nhận mã SMS và hoàn tất kích hoạt
ACCESS_READY - điện thoại đã sẵn sàng để nhận tin nhắn SMS
ACCESS_RETRY_GET - Chờ tin nhắn SMS mới
STATUS_OK - Dịch: Dịch vụ đã được kích hoạt thành công
ACCESS_CANCEL - Kích hoạt đã bị hủy
CÓ THỂ CÓ LỖI:NO_ACTIVATION - Sai mã kích hoạt
BAD_STATUS - Trạng thái không chính xác
EARLY_CANCEL_DENIED - tạm thời không thể hủy kích hoạt
BAD_KEY - khóa API không hợp lệ
BAD_ACTION - hành động không chính xác
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country
$api_key - Khóa API của bạn
Trả lời:'{"$country":{"$service":{"cost":price,"count":count_of_phones}}}'
Các lỗi có thể xảy ra:BAD_KEY - khóa API không hợp lệ
BAD_SERVICE - Tên dịch vụ không chính xác
BAD_COUNTRY - Mã quốc gia không chính xác
BAD_VALUES - giá trị tham số không hợp lệ
BAD_ACTION - hành động không chính xác
https://api.tiger-sms.com/stubs/handler_api.php?api_key=$api_key&action=getProviders&service=$service&country=$country
$api_key - Khóa API của bạn
$service - dịch vụ (tùy chọn) Tham khảo bảng
$country - mã quốc gia (tùy chọn) Tham khảo bảng
Trả lời:[
{
"id": 320,
"name": "Provider320",
"numbers_count": 411560,
"delivery_percent": 2.16,
"number_lifetime": 20
},
{
"id": 321,
"name": "Provider321",
"numbers_count": 28455,
"delivery_percent": 13.67,
"number_lifetime": 20
}
]
API trả về JSON; trên trang này, ví dụ được hiển thị dưới dạng văn bản thuần không định dạng thêm.
Nếu không có nhà cung cấp nào khớp với bộ lọc, một mảng rỗng sẽ được trả về.
Các lỗi có thể xảy ra:BAD_KEY - khóa API không hợp lệ
BAD_SERVICE - mã định danh dịch vụ không đúng
BAD_COUNTRY - Mã định danh quốc gia không đúng
BAD_VALUES - Định dạng tham số không đúng
ERROR - Lỗi
wp
hn
ahs
wj
lh
erc
qi
hk
exc
ll
fw
ki
qkb
amq
acv
gn
ags
rh
amf
ko
bq
an
agw
aip
sa
ag
cs
qu
uk
zl
acy
wv
jj
rf
tm
aav
bt
bn
lp
ab
hx
hw
ajy
yn
nh
aeo
al
yo
am
afi
aee
aha
agh
alg
ot
pm
ml
wx
gk
rq
aco
abt
amo
hs
ajp
afd
aem
gr
atb
du
aup
kd
aej
ajl
av
ff
aws
aaw
azs
avu
qv
li
agy
agq
hl
ajd
nms
aev
bnk
vc
afh
bzs
cb
alu
adf
aar
aly
acx
abd
ov
um
ck
ie
agl
vd
aab
zn
zu
vcc
bgl
bl
zs
ri
uv
qjd
ww
el
qk
pt
lt
ahx
ht
bjp
ua
akq
fk
bz
rw
qn
ajr
tx
acp
akg
bok
adr
btl
aax
aci
abu
jw
sy
vo
aiz
ahm
bdb
vt
zt
bff
kh
mo
afc
ahe
ip
adx
iu
abi
aff
adp
uo
my
gw
cpl
cpt
ls
gj
it
oy
ii
ld
pc
alz
wd
ho
afa
pq
ix
ai
td
akn
cha
dr
acd
chi
chs
afk
chb
ir
adv
si
az
acu
yf
acz
hf
cle
fe
ael
jn
dd
et
agm
ql
abb
oe
pn
ajo
cfx
re
ne
xy2
vw
ctt
acg
zx
amn
jv
eg
om
aby
yg
wc
ahg
ax
lu
sx
ti
ahh
aje
abp
akk
ahi
ox
fr
aju
tj
oc
zk
dt
zz
xy
lx
os
xk
zv
ake
ds
ame
ud
dw
sd
akl
dz
agv
ac
bx
dsm
sv
cj
ak
ve
hz
fi
le
adl
akj
rz
dh
te
epl
uf
aek
cba
eng
ah
alq
yj
ba
kr
db
rm
fb
qz
alc
fal
xn
xy1
lm
fss
mr
ws
akd
ait
ug
adm
cn
fxp
ahy
agn
tv
aew
xt
flo
aeg
iy
abe
nz
kw
flc
gu
ajg
xg
amc
rk
kq
wz
kg
gq
zb
nj
fcl
abz
adh
mv
ahf
ng
aih
od
aja
bk
ou
xex
xe
af
wn
pa
ed
afx
gts
bc
cg
ajm
ul
cz
aiu
ajs
ala
gt
qe
nn
jd
nk
iz
gl
hm
aq
ams
mq
abk
ads
aeq
ez
bp
ni
aky
go
gch
gms
gf
aeb
ajn
amk
afe
abl
jg
agd
als
aet
yw
ln
xs
grz
alb
gul
akb
ik
gh
ach
rp
sj
aks
df
sp
or
au
hdfc
agp
gx
akp
en
vx
ss
yh
rt
vz
aii
ks
hyc
hff
ru
jl
gi
kp
un
gv
hun
pp
dq
amj
iq
cx
kk
pd
ib
im
iv
tp
fg
zq
ajw
ju
rl
xi
hy
inp
ig
ino
ajf
yv
agk
es
il
cf
us
ad
jc
dm
wt
ea
za
jgd
aec
agz
aay
hr
ic
xx
yx
hi
pu
aig
abx
zo
kt
aed
de
jz
ajx
bf
ra
fz
adk
aid
afo
uw
afz
klz
kl
kpc
pv
rv
kyk
sq
kb
vp
er
vq
fh
sb
dl
bb
pi
do
rd
pz
lfp
oo
xf
lkc
jf
me
aka
tn
ex
alh
lft
eu
di
lcb
su
mk
akm
rs
zi
oj
lkb
acc
qkc
dj
ale
tu
gz
afq
hq
ade
up
ma
lb
fd
oh
bm
hd
agj
agu
adg
axr
mxd
ahl
act
afb
ry
lg
hp
qr
lv
agx
agf
acj
uy
alp
cq
abf
dg
vy
bv
he
mxc
mc
mm
ey
op
yr
amh
bg
gy
fo
wk
aht
gm
hc
py
xp
qo
qg
qt
ji
bu
mop
ce
ajz
vr
aix
mh
xq
mpr
lw
ej
age
da
mul
alm
mjo
ha
fmm
afm
ur
qa
ae
iw
fy
mu
nl
ajq
jm
abn
je
na
nv
sw
rn
aft
aex
aij
aaq
nf
aey
ef
ald
px
ew
kz
agi
aiy
nmi
dv
tf
xo
ms
nov
pg
zy
aaa
alx
opl
zm
uz
ogn
vm
okk
og
lr
ly
ns
akf
sn
aep
aj
agg
ue
ob
zf
ahd
lo
omd
qh
ost
xh
aaz
aic
sg
afw
cw
abg
gg
dk
akz
zr
wo
dn
qb
akc
xz
nc
ts
jq
tr
ge
yp
pcp
at
fx
fc
fp
ev
zp
ro
jh
sz
ahp
aer
abs
adc
plt
ch
aag
pj
pco
rg
oz
adb
lq
fj
dx
aio
po
akh
aiq
afs
wu
abr
aa
alo
rpp
cm
dp
aga
amm
lk
ny
vf
qw
eq
zw
cc
alr
acr
acn
rlo
rkn
tc
rpd
aba
acm
jp
ajj
xu
qf
ci
co
aen
ow
aln
ij
zj
aau
afn
ga
qm
rnf
aif
ku
km
mn
rmb
adj
ec
fl
xb
so
kv
ay
ui
ako
shb
gs
lj
amg
qjk
ais
ahq
alt
pw
vv
ago
zg
adu
ajv
rx
shn
vg
ka
ze
bw
fs
alk
np
qbs
eo
afj
wg
sk
rc
pb
amd
aim
ado
agb
wm
fu
ph
snb
sf
ia
abw
akx
jy
mx
ain
acb
spp
ky
va
cd
alj
nt
la
sr
stc
mt
jo
ali
vj
ahj
nu
aiv
lc
aca
acq
ca
ahv
gd
swg
qji
jx
hg
tq
xc
tal
aw
xw
ei
tlb
aat
xr
aei
wh
tit
qd
abc
acs
ace
uc
ami
ih
tg
eh
ep
qq
cr
pla
aeu
lz
ahr
nm
rb
gp
alv
aki
lf
oi
aap
air
acl
xd
ack
uq
nr
fm
bs
gc
mw
abj
pr
nq
tl
ada
jt
afy
ee
hb
tw
aho
ub
ahb
ubx
cp
hu
afr
qjz
hh
abq
agt
of
bh
ao
cl
adq
yy
ajk
amb
amp
kn
afp
vi
alw
fv
agc
kc
no
kx
oq
sc
akr
voi
eb
afl
abh
wr
cv
ajh
abo
alf
wb
amr
kf
mf
wlf
th
ja
wa
wa2
qj
uu
adt
akw
wnl
jb
ta
mp
qeg
acf
qko
vs
bo
xv
wyc
xl
rr
wmp
ar
won
woh
ama
qx
bd
fa
aml
yu
nw
xqq
akt
aas
vn
mb
yl
wy
wf
kj
yi
dc
agr
acw
wl
gb
sm
uh
adn
ye
mj
ahw
ys
ps
em
afg
adi
qy
tt
zd
zh
mz
dy
ail
zon
zub
mi
aik
rhw
aeh
st
md
ajb
ahk
ft
aef
nb
bj
vk
sh
br
afu
gzp
js
ajt
rj
afv
ux
we
io
zyy
aes
yb
fq
vb
ahz
ct
tz
xm
mg
ol
qp
tk
aji
qs
ok
ty
yz
vl
pl
ptr
ajc
qc
adw
ahn
cy
uj
jr
sl
xj
be
sbt
ybb
yk
hj
sut
aiw
wtt
ady
xa
abm
yq
aie
abv
chc
adz
vh
ke
ut
ym
ya
bi
cu
yd
74
155
58
76
181
169
39
148
179
175
50
35
122
145
60
118
51
82
124
120
195
158
92
108
123
73
121
83
152
119
24
41
36
186
170
125
42
151
33
133
150
18
93
27
45
113
77
63
172
168
126
109
105
21
101
167
176
34
71
189
163
78
162
154
28
128
43
38
129
127
160
94
68
130
131
26
88
14
84
132
22
6
57
47
23
13
86
103
182
116
2
8
190
203
100
11
25
49
153
136
135
102
44
165
20
183
17
137
7
159
69
199
114
157
54
85
144
72
171
180
37
80
5
138
81
48
185
67
90
139
19
174
107
66
188
112
79
87
65
4
15
117
97
111
146
32
140
134
164
166
198
178
53
61
29
184
115
196
141
59
193
149
31
177
56
64
98
142
106
46
173
110
55
143
9
52
91
99
197
104
89
62
161
75
1
95
16
187
1001
12
156
40
70
10
30
147
96