sms-activate 호환 엔드포인트

많은 도구에서 sms-activate 프로토콜을 사용합니다. 호환 엔드포인트가 있으므로 기본 URL 주소를 바꾸고 SmsGrab API 키를 쓰면 이런 도구가 작동합니다.

엔드포인트

https://smsgrab.com/api/stubs/handler_api.php

api_key 값과 action 값을 액션 매개변수와 함께 GET 또는 POST 방식으로 보냅니다. 키는 Authorization: Bearer 헤더로 보낼 수도 있습니다.

예시

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"

ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

지원 액션

ID

• 서비스에는 프로토콜의 짧은 코드가 있으면 그것을 씁니다. 예를 들어 wa WhatsApp, tg Telegram, go Google, fb Facebook, ig Instagram, ds Discord 등입니다. SmsGrab 서비스 ID 값도 쓸 수 있습니다.
• 국가에는 프로토콜의 숫자 ID 값이 있으면 그것을 씁니다. 예를 들어 0 러시아, 6 인도네시아, 4 필리핀, 22 인도, 187 미국 등입니다. SmsGrab ID 값과 ISO 코드도 쓸 수 있습니다.
• getCountries 및 getServicesList 액션은 최신 전체 목록을 반환합니다.
• 활성화 id 값은 100000123 같은 숫자이며, REST API 호출에서도 쓸 수 있습니다.

알아 둘 차이점

• 금액은 미국 달러이며 소수점 둘째 자리까지, 내 개발자 가격으로 표시됩니다. 루블이 아닙니다.
• operator 값은 무시되며, 이용 가능한 가장 좋은 상품이 자동으로 선택됩니다.
• 오류는 원래 프로토콜처럼 HTTP 200 상태와 NO_NUMBERS, NO_BALANCE, BAD_KEY 같은 텍스트로 응답합니다. 요청이 너무 많으면 TOO_MANY_REQUESTS 텍스트와 함께 HTTP 429 상태를 받습니다.
• NO_ACCESS 응답은 키에 purchase 범위가 없거나, IP 주소가 허용되지 않았거나, 일일 사용 한도에 도달했다는 뜻입니다.
• 이 엔드포인트에서는 대여를 이용할 수 없습니다.

나머지는 REST API 방식과 같습니다. 키, 한도, 가격, 환불, 웹훅 설정도 모두 공통입니다.