API v12026-11-04

인증

콘솔에서 API 키를 생성하세요. API 키는 한 번만 표시되며, 우리는 암호화된 복사본만 보관해요. Authorization 헤더에 베어러 토큰으로 전송하세요. 헤더를 설정할 수 없는 도구의 경우 key 매개변수도 허용해요.

Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

새 키를 만들면 바로 이전 키가 교체돼요. 서비스, 국가 및 가격 엔드포인트는 키 없이도 작동해요.

오류

빠른 시작

curl로 UK WhatsApp 번호를 주문한 후, 코드가 도착할 때까지 몇 초마다 주문을 폴링하세요.

curl -X POST https://snsverify.com/api/v1/orders \
  -H "Authorization: Bearer $SNSVERIFY_KEY" \
  -d service=whatsapp -d country=gb

Python

import os, time, requests

API = "https://snsverify.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSVERIFY_KEY']}"}

order = requests.post(f"{API}/orders", headers=H,
    data={"service": "whatsapp", "country": "gb"}).json()["order"]
print("Use this number:", order["phone"])

while True:
    o = requests.get(f"{API}/orders/{order['id']}", headers=H).json()["order"]
    if o["code"] or o["status"] in ("refunded", "canceled"):
        break
    time.sleep(4)
print("Code:", o["code"])

Node.js

const API = "https://snsverify.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSVERIFY_KEY}` };

const { order } = await fetch(`${API}/orders`, {
  method: "POST", headers: H,
  body: new URLSearchParams({ service: "telegram", country: "nl" }),
}).then((r) => r.json());
console.log("Use this number:", order.phone);

let o = order;
while (!o.code && !["refunded", "canceled"].includes(o.status)) {
  await new Promise((r) => setTimeout(r, 4000));
  ({ order: o } = await fetch(`${API}/orders/${order.id}`, { headers: H }).then((r) => r.json()));
}
console.log("Code:", o.code);

요청 제한

API 키당 분당 300회 요청이 가능하고, 계정당 최대 20개의 주문을 동시에 진행할 수 있어요. 주문 상태는 3~5초마다 확인하는 게 적당해요. 대부분의 인증 코드는 1분 이내에 도착하니까요.

주문 상태

• waiting 인증 번호가 활성화되었지만 아직 코드가 도착하지 않았어요.
• received 적어도 하나의 코드가 도착했어요. 코드 대기 시간이 열려 있는 동안 resend로 다른 코드를 요청하세요.
• finished 코드 수신 후 또는 코드 대기 시간이 끝나면 종료돼요.
• refunded 코드 대기 시간이 종료되었지만 코드가 도착하지 않았어요. 전체 금액이 크레딧으로 환불되었어요.
• canceled 인증 코드가 오기 전에 취소하셨기 때문에 전체 금액이 크레딧으로 환불되었어요.

엔드포인트

{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}

{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}

{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}

{"balance":"25.00","currency":"USD"}

{"order":{"id":"AC-7K2M9QX4PB","service":"whatsapp","country":"gb","phone":"+447700900123","price":"0.94","status":"waiting","code":null,"expires_at":"2026-11-04T12:20:00.000Z"},"window_minutes":20}

{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}

{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}

{"order":{"status":"received","waiting_for_resend":true}}

{"order":{"status":"finished"}}

{"order":{"status":"canceled","refunded":"0.94"}}