SMS 인증 API

간단한 HTTP GET 또는 POST 요청으로 번호 구매 및 SMS 코드 확인이 가능해요. 일반적인 SMS 인증 도구의 텍스트 형식으로 응답하며, 전용 번호 호출은 JSON으로 응답해요.

시작하기

주소: https://snscodes.com/stubs/handler_api.php
인증: api_key 매개변수. 계정의 API 페이지에서 키를 생성할 수 있으며, 한 번만 표시돼요.
요청 제한: 키당 분당 300회 요청
금액: 가격과 크레딧은 미국 달러로 표시되며, 웹사이트와 동일한 크레딧에서 차감돼요.

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=telegram&country=us"
# ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=N-7KQ2M9XWD4"
# STATUS_OK:482913

import time, requests
BASE = "https://snscodes.com/stubs/handler_api.php"
KEY = "YOUR_KEY"

r = requests.get(BASE, params={"api_key": KEY, "action": "getNumber", "service": "telegram", "country": "us"}).text
_, num_id, phone = r.split(":")
print("number", phone)
while True:
    s = requests.get(BASE, params={"api_key": KEY, "action": "getStatus", "id": num_id}).text
    if s.startswith("STATUS_OK"):
        print("code", s.split(":")[1]); break
    if s == "STATUS_CANCEL":
        break
    time.sleep(5)

const BASE = "https://snscodes.com/stubs/handler_api.php";
const KEY = process.env.SNSCODES_KEY;
const call = async (q) => (await fetch(BASE + "?" + new URLSearchParams({ api_key: KEY, ...q }))).text();

const [, id, phone] = (await call({ action: "getNumber", service: "telegram", country: "us" })).split(":");
console.log("number", phone);
for (;;) {
  const s = await call({ action: "getStatus", id });
  if (s.startsWith("STATUS_OK")) { console.log("code", s.split(":")[1]); break; }
  if (s === "STATUS_CANCEL") break;
  await new Promise((r) => setTimeout(r, 5000));
}

크레딧 확인 action=getBalance

계정 크레딧을 미국 달러로 반환해요.

응답

ACCESS_BALANCE:42.50

BAD_KEY키가 없거나 잘못되었어요.

코드 가격 action=getPrices

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

파라미터	필수	설명
service	아니오	서비스 코드, 예: telegram
country	아니오	us, gb 또는 au

응답

{"us":{"telegram":{"cost":3,"count":100}}}

코드용 번호 구매 action=getNumber

하나의 앱에 대해 하나의 번호를 구매해요. 가격은 즉시 크레딧에서 차감되며, 20분 내에 코드가 도착하지 않으면 반환돼요.

파라미터	필수	설명
service	예	getPrices의 서비스 코드
country	예	us, gb 또는 au

응답

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICE알 수 없는 서비스 코드예요.
BAD_COUNTRY이 국가에서는 서비스를 제공하지 않아요.
NO_BALANCE크레딧이 부족해요. 요금이 청구되지 않았어요.
NO_NUMBERS현재 사용 가능한 번호가 없어요. 요금이 청구되지 않았어요.
NO_ACTIVATIONS이미 20개의 코드용 번호를 사용 중이에요.

코드 읽기 action=getStatus

코드가 도착할 때까지 5~10초마다 폴링하세요.

파라미터	필수	설명
id	예	getNumber의 id

응답

STATUS_OK:482913

STATUS_WAIT_CODE아직 SMS가 도착하지 않았어요.
STATUS_WAIT_RETRY:482913다른 코드를 기다리는 중이에요; 마지막 코드가 표시되고 있어요.
STATUS_CANCEL취소되거나 환불되었어요.
NO_ACTIVATION알 수 없는 ID예요.

취소, 재시도 또는 완료 action=setStatus

status=8은 코드 없이 번호를 취소해요(전액 환불), status=3은 같은 번호로 다른 코드를 요청해요, status=6은 완료해요.

파라미터	필수	설명
id	예	getNumber의 id
status	예	8, 3 또는 6

응답

ACCESS_CANCEL

EARLY_CANCEL_DENIED인증 코드가 이미 도착했어요. 취소하지 말고 완료하세요.
ACCESS_RETRY_GET다른 코드를 기다리는 중이에요.
ACCESS_ACTIVATION완료되었어요.

전용 번호 가격 action=getRentPrices

국가와 기간별 전체 기간 가격이에요. JSON을 반환해요.

파라미터	필수	설명
country	아니오	2자리 국가 코드

응답

{"us":{"sixMonths":35.99,"twelveMonths":59.99}}

전용 번호 구매하기 action=getRentNumber

기간 동안 전용 번호를 구매해요. JSON을 반환해요.

파라미터	필수	설명
country	예	2자리 국가 코드
period	예	oneMonth, threeMonths, sixMonths, twelveMonths, twoYears 또는 threeYears

응답

{"status":"success","id":"N-3HV8QZ2K5M","phone":"14155550123","until":"2027-05-02T10:00:00.000Z"}

BAD_PERIOD이 국가에서는 해당 기간을 판매하지 않아요.
NO_BALANCE크레딧이 부족해요.

전용 번호 SMS 읽기 action=getRentStatus

지금까지 전용 번호로 받은 모든 SMS예요. JSON을 반환해요.

파라미터	필수	설명
id	예	getRentNumber에서 받은 id

응답

{"status":"success","state":"active","messages":[{"code":"482913","text":"Your code is 482913","from":"Telegram","at":"..."}]}

전용 번호 취소하기 action=setRentStatus

status=2로 설정하면 SMS가 도착하지 않았고 20분 이내일 때 전용 번호를 취소하고 전액 환불받을 수 있어요.

파라미터	필수	설명
id	예	getRentNumber에서 받은 id
status	예	2

응답

{"status":"success"}

EARLY_CANCEL_DENIEDSMS가 도착했거나 20분이 지났어요.