SMS 인증 API
자신의 스크립트로 인증 번호를 구매하고 코드를 확인할 수 있어요. 일반적인 SMS 액티베이션 형식의 API를 사용하기 때문에, 기존 클라이언트에서 기본 주소와 키만 변경하면 바로 사용할 수 있어요.
기본 주소와 키
GET 또는 POST 요청을 기본 주소에 api_key와 action을 포함해서 보내세요. 콘솔의 API 키 페이지에서 키를 생성할 수 있어요. 키는 한 번만 표시돼요.
https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance
서비스 코드는 저희 서비스 페이지에 표시된 이름이에요 (예: whatsapp, telegram, google). 국가 코드는 소문자 ISO 코드로 표시돼요 (us, gb, in). 분당 최대 300회 요청할 수 있어요. 각 액티베이션은 콘솔에서와 동일하게 20분 동안 유효해요.
getBalance
USD로 표시된 크레딧.
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance
ACCESS_BALANCE:12.50
getServicesList
구매 가능한 서비스 코드 (JSON).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList
{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}getCountries
국가 코드 (ISO, 소문자)와 전화 코드 (JSON).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries
{"us":{"name":"United States","dial":"1"}}getPrices
USD 기준 가격과 국가별 서비스 재고 현황이에요. 필터는 선택 사항이에요.
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us
{"us":{"whatsapp":{"cost":0.18,"count":130598}}}getNumber
액티베이션을 구매해요. 액티베이션 ID와 국가 코드가 포함된 번호를 반환해요.
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us
ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182
getStatus
STATUS_WAIT_CODE (아직 코드 없음), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (다른 코드 요청), STATUS_CANCEL (취소 또는 환불됨).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB
STATUS_OK:482913
setStatus
status=1 준비됨 (ACCESS_READY), 3 다른 코드 (ACCESS_RETRY_GET), 6 완료 (ACCESS_ACTIVATION), 8 코드가 도착하지 않은 상태에서 전체 환불로 취소 (ACCESS_CANCEL).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3
ACCESS_RETRY_GET
일반적인 흐름
- 서비스와 국가로 getNumber를 호출하세요. ID를 저장하세요.
- 앱에 번호를 입력하고 SMS를 요청하세요.
- STATUS_OK가 될 때까지 5~10초마다 getStatus를 호출하세요.
- 다른 SMS가 필요하세요? setStatus 3, 그런 다음 다시 getStatus를 호출하세요. 완료: setStatus 6.
- 인증 코드가 안 왔나요? setStatus 8로 취소하면 전액 환불받을 수 있어요. 통화가 없으면 대기 시간이 끝나면 자동으로 환불돼요.
오류
| 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건의 액티베이션이 진행 중이에요. |