选择语言

开发者 API

短信验证 直接接入您的代码

一次 HTTPS 调用,即可为您的机器人或平台获取用于 WhatsApp、Telegram 等众多服务的真实号码。通过 Webhook 或长轮询接收验证码,只为收到验证码的号码付费。

  • 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、幂等购买,以及可据此处理的清晰错误原因。

  • 签名 Webhook

    每次收到验证码或状态变化都会推送 HMAC 签名事件,并在 24 小时内重试。

  • 长轮询

    请求最长可保持 25 秒,验证码一到即刻返回。

  • 兼容 sms-activate

    把现有工具指向我们的接口即可,操作和响应保持不变。

  • 由您掌控的密钥

    只读或可购买密钥、IP 白名单、每日上限、有效期,以及不停机轮换。

  • 自动退款

    号码到期前未收到验证码?款项立即退回您的余额。

  • 用量与请求日志

    按密钥查看每日请求、支出和错误,并提供可筛选的近 7 天日志。

  • 阶梯用量价格

    与 App 相同的价格,折扣随你的月用量自动增加。

四步即可上手

只需几次调用,就能拿到第一个号码。

  1. 创建账户

    使用邮箱注册并完成验证。应用和网站共用同一账户。

  2. 创建 API 密钥

    选择权限,把密钥限制在您的服务器上,并复制一次密钥值。

  3. 购买号码

    POST 服务和国家,号码和价格立即返回。

  4. 接收验证码

    通过长轮询或 Webhook 等待验证码,然后完成激活。

用得越多,价格越低

API 的价格与 App 相同。你的批发折扣随所有渠道最近 30 天的消费增长。

  • 绝不高于应用内同一号码的价格
  • 未收到验证码的号码自动退款
  • 达到等级后几分钟内生效
  • 以美元从与应用相同的余额中扣款

按 30 天消费计算的折扣

用量档位目前未启用。你支付与 App 相同的价格,获批经销商仍享有固定折扣。

迁移

改一行代码即可从 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 相同的密钥、限制、价格、退款和 Webhook
兼容性参考

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 接口。

  • 号码已购买
  • 已收到验证码
  • 激活已完成
  • 激活已取消
  • 激活已过期
  • 已退款
  • 余额不足
  • 充值已创建
  • 充值确认中
  • 充值已到账
  • 充值已过期
  • 充值审核中
Webhook 指南
600每个密钥每分钟请求数
60每个密钥每分钟购买数
100同时等待的号码
25秒长轮询
  • 每次推送均使用带时间戳的 HMAC-SHA256 签名
  • 仅支持公网 HTTPS 接口,每次推送前都会检查
  • 测试推送、30 天记录和一键重新推送

开发者常见问题

开发者 API 如何收费?

没有订阅费。每个号码的价格与 App 相同,并从同一余额支付。随着你 30 天消费的增长,用量档位会降低这个价格,获批经销商还享有固定折扣。收不到验证码的号码会自动退款。

收不到验证码怎么办?

号码在其显示的到期时间之前有效,通常为 10 到 20 分钟。若期间未收到验证码,或您在等待中取消号码,款项会自动退回余额。

能继续使用我的 sms-activate 集成吗?

可以。把基础 URL 改为我们的兼容接口并使用 SmsGrab 密钥即可,标准操作、响应和数字 ID 均保持不变。

频率限制是多少?

默认情况下,每个密钥每分钟可发起 600 次请求和 60 次购买,账户下所有密钥合计每分钟 3000 次请求,最多 100 个号码可同时等待验证码。

如何保护我的密钥?

只在服务器上保存密钥,为每个应用单独创建密钥,限制为服务器地址并设置每日消费上限。如密钥可能泄露,请在账户中轮换或吊销。

应用和 API 共用余额吗?

是的。API 使用您的 SmsGrab 账户余额,每笔购买和退款都会像其他交易一样显示在钱包中。

更多解答请访问 帮助中心

准备好自动化验证了吗?

在账户中创建密钥,几分钟内即可完成首次调用。