언어 선택

개발자 API

SMS 인증을 코드에서 바로

HTTPS 호출 한 번으로 봇이나 플랫폼이 WhatsApp, Telegram 등 다양한 서비스용 실제 번호를 받습니다. 코드는 웹훅이나 롱 폴링으로 받고, 코드를 받은 번호에만 비용을 지불하세요.

  • 2,281개 서비스
  • 200개국
  • 자동코드 미수신 시 환불

curl

curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia"}'

Python

activation = requests.post(
    "https://smsgrab.com/api/dev/v1/activations",
    headers={"Authorization": f"Bearer {key}", "Idempotency-Key": str(uuid.uuid4())},
    json={"service": "whatsapp", "country": "indonesia"},
    timeout=30,
).json()

Node.js

const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${key}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());

PHP

$activation = json_decode((string) $client->post('activations', [
    'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
    'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->getBody(), true);

Go

order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation)
201 Created
{
  "id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
  "compat_id": 100000123,
  "status": "WAITING_SMS",
  "service_id": "whatsapp",
  "country_id": "indonesia",
  "phone_number": "+6281234567890",
  "price_minor": 17,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

자동화를 위해 설계

앱과 같은 번호 재고, 정산, 환불로 연동에 필요한 모든 것을 제공합니다.

  • 간결한 REST API

    예측 가능한 JSON, 멱등 구매, 바로 대응할 수 있는 명확한 오류 사유.

  • 서명된 웹훅

    코드와 상태 변경마다 HMAC 서명 이벤트를 보내고 24시간 동안 재시도합니다.

  • 롱 폴링

    요청을 최대 25초간 유지하고 코드가 도착하는 즉시 받으세요.

  • sms-activate 호환

    기존 도구의 주소만 저희 엔드포인트로 바꾸세요. 액션과 응답은 그대로입니다.

  • 직접 통제하는 키

    읽기 전용 또는 구매 키, IP 허용 목록, 일일 한도, 만료, 중단 없는 교체.

  • 자동 환불

    번호가 만료될 때까지 코드가 오지 않으면 즉시 잔액으로 환불됩니다.

  • 사용량과 요청 로그

    키별 일일 요청, 지출, 오류와 최근 7일간의 필터 가능한 로그.

  • 사용량 기반 가격

    앱과 같은 가격에, 월 이용량에 따라 자동으로 커지는 할인.

4단계로 시작

첫 번호까지 몇 번의 호출이면 충분합니다.

  1. 계정 만들기

    이메일로 가입하고 인증하세요. 앱과 웹사이트는 같은 계정을 사용합니다.

  2. API 키 만들기

    권한을 선택하고 키를 서버로 제한한 뒤 시크릿을 한 번 복사하세요.

  3. 번호 구매

    서비스와 국가를 POST하면 번호와 가격이 바로 반환됩니다.

  4. 코드 받기

    롱 폴링이나 웹훅으로 기다린 뒤 활성화를 완료하세요.

성장할수록 낮아지는 가격

API 가격은 앱과 같습니다. 대량 구매 할인은 모든 채널의 최근 30일 지출에 따라 커집니다.

  • 앱의 같은 번호보다 비싸지 않습니다
  • 코드를 받지 못한 번호는 자동 환불
  • 등급은 도달 후 몇 분 안에 갱신
  • 앱과 같은 잔액에서 USD로 청구

30일 지출별 할인

볼륨 등급이 현재 중지되어 있습니다. 앱과 같은 가격을 내며, 승인된 리셀러는 고정 할인을 받습니다.

이전

한 줄만 바꿔 sms-activate에서 이전

호환 엔드포인트는 같은 프로토콜을 사용하므로 sms-activate용 봇과 패널은 기본 URL과 키만 바꾸면 작동합니다.

SMS-Activate는 2025년 12월에 서비스를 종료했습니다. 도구의 연결 주소를 SmsGrab으로 바꾸면 계속 사용할 수 있습니다.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices 등 표준 액션
  • 이미 사용 중인 숫자형 활성화 ID, 서비스 코드, 국가 ID
  • REST API와 같은 키, 한도, 가격, 환불, 웹훅
호환성 레퍼런스

curl

BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"

curl -s -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"

Python

import os
import time

import requests

BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]


def action(name: str, **params) -> str:
    response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
    response.raise_for_status()
    return response.text


print(action("getBalance"))
answer = action("getNumber", service="tg", country=6, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
    raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)

while True:
    status = action("getStatus", id=activation_id)
    if status.startswith("STATUS_OK:"):
        print("Code:", status.split(":", 1)[1])
        action("setStatus", id=activation_id, status=6)
        break
    if status == "STATUS_CANCEL":
        print("Cancelled or expired, the charge was refunded")
        break
    time.sleep(5)

Node.js

const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';

async function action(name, params = {}) {
  const url = new URL(BASE);
  url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
  const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }
  return response.text();
}

console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
  throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);

for (;;) {
  const status = await action('getStatus', { id });
  if (status.startsWith('STATUS_OK:')) {
    console.log('Code:', status.slice('STATUS_OK:'.length));
    await action('setStatus', { id, status: '6' });
    break;
  }
  if (status === 'STATUS_CANCEL') {
    console.log('Cancelled or expired, the charge was refunded');
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

PHP

<?php

function smsgrab(string $action, array $params = []): string
{
    $query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
    $answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
    if ($answer === false) {
        throw new RuntimeException('The request failed');
    }

    return $answer;
}

echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
    exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;

while (true) {
    $status = smsgrab('getStatus', ['id' => $id]);
    if (str_starts_with($status, 'STATUS_OK:')) {
        echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
        smsgrab('setStatus', ['id' => $id, 'status' => 6]);
        break;
    }
    if ($status === 'STATUS_CANCEL') {
        echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
        break;
    }
    sleep(5);
}

Go

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
	"strings"
	"time"
)

const base = "https://smsgrab.com/api/stubs/handler_api.php"

var client = &http.Client{Timeout: 30 * time.Second}

func action(name string, params url.Values) (string, error) {
	query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
	for key, values := range params {
		query[key] = values
	}
	response, err := client.Get(base + "?" + query.Encode())
	if err != nil {
		return "", err
	}
	defer response.Body.Close()
	body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
	if err != nil {
		return "", err
	}
	if response.StatusCode != http.StatusOK {
		return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
	}
	return string(body), nil
}

func main() {
	answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
	if err != nil {
		panic(err)
	}
	if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
		fmt.Println(answer)
		return
	}
	parts := strings.Split(answer, ":")
	id := parts[1]
	fmt.Println("Number:", parts[2])
	for {
		status, err := action("getStatus", url.Values{"id": {id}})
		if err != nil {
			panic(err)
		}
		if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
			fmt.Println("Code:", code)
			if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
				panic(err)
			}
			return
		}
		if status == "STATUS_CANCEL" {
			fmt.Println("Cancelled or expired, the charge was refunded")
			return
		}
		time.Sleep(5 * time.Second)
	}
}

실시간

코드를 서버로 바로

필요한 이벤트를 구독하면 검증 가능한 서명과 함께 HTTPS 엔드포인트로 전송합니다.

  • 번호 구매
  • 코드 수신
  • 활성화 완료
  • 활성화 취소
  • 활성화 만료
  • 환불됨
  • 잔액 부족
  • 충전 생성됨
  • 충전 확인 중
  • 충전 반영됨
  • 충전 만료됨
  • 충전 검토 중
웹훅 가이드
600키당 분당 요청
60키당 분당 구매
100동시 대기 번호
25초 롱 폴링
  • 모든 전송에 타임스탬프가 포함된 HMAC-SHA256 서명
  • 공개 HTTPS 엔드포인트만 허용하며 전송마다 사전 확인
  • 테스트 전송, 30일 기록, 클릭 한 번으로 다시 보내기

개발자 질문

개발자 API 요금은 얼마인가요?

구독은 없습니다. 각 번호의 가격은 앱과 같고 같은 잔액에서 결제됩니다. 30일 지출이 늘수록 볼륨 등급이 이 가격을 낮추고, 승인된 리셀러는 고정 할인을 받습니다. 코드가 오지 않은 번호는 자동으로 환불됩니다.

코드가 오지 않으면 어떻게 되나요?

번호는 함께 표시되는 만료 시각까지 유효하며 보통 10~20분입니다. 그 사이 코드가 오지 않거나 대기 중에 번호를 취소하면 자동으로 잔액에 환불됩니다.

기존 sms-activate 연동을 쓸 수 있나요?

네. 기본 URL을 호환 엔드포인트로 바꾸고 SmsGrab 키를 사용하세요. 표준 액션, 응답, 숫자형 ID는 그대로입니다.

속도 제한은 어떻게 되나요?

기본적으로 키마다 분당 600건의 요청과 60건의 구매, 계정의 모든 키를 합쳐 분당 3000건의 요청이 가능하며, 최대 100개의 번호가 동시에 코드를 기다릴 수 있습니다.

키를 어떻게 보호하나요?

키는 서버에만 보관하고, 앱마다 별도의 키를 쓰고, 서버 주소로 제한하고, 일일 지출 한도를 설정하세요. 유출이 의심되면 계정에서 교체하거나 폐기하세요.

앱과 API가 잔액을 공유하나요?

네. API는 SmsGrab 계정 잔액을 사용하며, 모든 구매와 환불은 다른 거래처럼 지갑에 표시됩니다.

더 많은 답변은 고객센터

인증을 자동화할 준비가 되셨나요?

계정에서 키를 만들고 몇 분 안에 첫 호출을 해 보세요.