개발자 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)
{
"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일간의 필터 가능한 로그.
-
사용량 기반 가격
앱과 같은 가격에, 월 이용량에 따라 자동으로 커지는 할인.
이전
한 줄만 바꿔 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)
}
}
개발자 질문
개발자 API 요금은 얼마인가요?
구독은 없습니다. 각 번호의 가격은 앱과 같고 같은 잔액에서 결제됩니다. 30일 지출이 늘수록 볼륨 등급이 이 가격을 낮추고, 승인된 리셀러는 고정 할인을 받습니다. 코드가 오지 않은 번호는 자동으로 환불됩니다.
코드가 오지 않으면 어떻게 되나요?
번호는 함께 표시되는 만료 시각까지 유효하며 보통 10~20분입니다. 그 사이 코드가 오지 않거나 대기 중에 번호를 취소하면 자동으로 잔액에 환불됩니다.
기존 sms-activate 연동을 쓸 수 있나요?
네. 기본 URL을 호환 엔드포인트로 바꾸고 SmsGrab 키를 사용하세요. 표준 액션, 응답, 숫자형 ID는 그대로입니다.
속도 제한은 어떻게 되나요?
기본적으로 키마다 분당 600건의 요청과 60건의 구매, 계정의 모든 키를 합쳐 분당 3000건의 요청이 가능하며, 최대 100개의 번호가 동시에 코드를 기다릴 수 있습니다.
키를 어떻게 보호하나요?
키는 서버에만 보관하고, 앱마다 별도의 키를 쓰고, 서버 주소로 제한하고, 일일 지출 한도를 설정하세요. 유출이 의심되면 계정에서 교체하거나 폐기하세요.
더 많은 답변은 고객센터