SMS 인증 API

기존에 사용 중인 도구를 위한 일반 텍스트 액티베이션 형식이에요. 새로운 통합은 REST API도 사용할 수 있어요.

인증 번호 소개

모든 호출은 API 키와 action 파라미터를 포함한 https://snsverify.com/stubs/handler_api.php에 대한 GET(또는 POST) 요청이에요. 키는 콘솔의 API 키 페이지에서 가져올 수 있으며, 비밀로 유지해야 해요. 이 키는 크레딧을 사용할 수 있어요. 응답은 ACCESS_NUMBER 또는 STATUS_OK와 같은 짧은 텍스트 줄이거나, 이 형식을 사용하는 다른 서비스와 마찬가지로 목록 작업에 대한 JSON이에요.

같은 계정, 같은 규칙이에요. 여기서 구매한 번호는 웹사이트와 동일한 가격, 동일한 20분 코드 대기 시간, 동일한 자동 환불 정책을 사용해요. 서비스 코드는 우리 사이트에서 보이는 소문자 이름이에요(whatsapp, telegram, google); 국가 코드는 ISO: us, gb, nl, de, af, al, dz, ao, ai, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bt, bo, ba, bw, br, bn, bg, bi, kh, cm, ca, td, cl, cn, co, km, hr, cy, cz, dk, dj, dm, ec, eg, er, ee, sz, et, fj, fi, fr, ga, gm, ge, gh, gi, gr, gd, gp, gt, gn, gy, ht, hn, hk, hu, is, in, id, iq, ie, il, it, jm, jp, jo, kz, ke, kw, kg, la, lv, lb, ls, lr, lt, lu, mo, mg, mw, my, mv, ml, mt, mr, mu, mx, md, mc, mn, me, ms, ma, mz, na, np, nz, ni, ne, ng, no, om, pk, pa, py, pe, ph, pl, pt, qa, ro, rw, sn, rs, sc, sg, sk, si, so, za, es, sr, se, ch, tw, tj, tz, th, tg, tn, tr, tm, ug, ua, uy, uz, ve, vn, ye, zm, zw예요.

getBalance (GET) [+]

USD로 표시된 크레딧.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getBalance

응답

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

구매 가능한 서비스 코드(JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getServicesList

응답

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries (GET) [+]

국가 코드(ISO, 소문자)와 국가별 전화 코드(JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getCountries

응답

{"gb":{"name":"United Kingdom","dial":"44"}}

getPrices (GET) [+]

국가 및 서비스별 USD 가격이에요. 두 필터 모두 선택 사항이에요.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getPrices&service=whatsapp&country=gb

응답

{"gb":{"whatsapp":{"cost":0.94,"count":100}}}

getNumber (GET) [+]

인증용 번호를 구매해요. 액티베이션 ID와 국가 코드가 포함된 번호를 반환해요.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=whatsapp&country=gb

응답

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE(아직 코드 없음), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code>(다른 코드 요청됨), STATUS_CANCEL(취소 또는 환불됨).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=AC-7K2M9QX4PB

응답

STATUS_OK:482915

setStatus (GET) [+]

status=1 준비 완료(ACCESS_READY), 3 다른 코드 요청(ACCESS_RETRY_GET), 6 완료(ACCESS_ACTIVATION), 8 코드 도착 전 전체 환불 취소(ACCESS_CANCEL).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

응답

ACCESS_RETRY_GET

일반적인 흐름

서비스와 국가를 지정해 getNumber를 호출하세요. 액티베이션 ID를 저장하고 번호를 앱에 입력하세요.
앱에서 SMS를 보냈다면 setStatus를 status=1로 호출하세요(선택 사항, 액티베이션 준비 완료 표시만 함).
3~5초마다 getStatus를 폴링하여 STATUS_OK와 코드가 반환될 때까지 기다리세요.
다른 코드가 필요하세요? setStatus status=3을 호출한 후, STATUS_OK로 새 코드가 표시될 때까지 다시 폴링하세요.
완료: setStatus status=6. 코드가 오지 않았고 지금 환불을 원하시면: setStatus status=8 (코드가 도착하기 전에만 가능해요). 그렇지 않으면 20분 후에 액티베이션이 자동으로 환불돼요.

오류 응답

BAD_KEY	API 키가 없거나 잘못되었어요.
BAD_ACTION	알 수 없는 동작이에요.
BAD_SERVICE	알 수 없는 서비스 코드예요.
BAD_COUNTRY	해당 국가에서는 서비스를 제공하지 않아요.
NO_BALANCE	크레딧이 부족해요.
NO_NUMBERS	지금은 사용 가능한 번호가 없어요. 잠시 후에 다시 시도해 보세요.
NO_ACTIVATION	알 수 없는 액티베이션 ID이거나 본인 소유가 아니에요.
EARLY_CANCEL_DENIED	이미 코드가 도착했기 때문에 액티베이션을 취소할 수 없어요.
TOO_MANY_REQUESTS	1분에 300건 이상의 요청이 들어왔어요.
NO_ACTIVATIONS	이미 20개의 액티베이션이 진행 중이에요.

제한: 키당 분당 300회 요청, 계정당 최대 20개의 열린 액티베이션. 2026-11-04 기준 가격