• 覆盖 228 个目的地
  • 始终无需 KYC
  • 支持 Bitcoin、Monero、USDT 等 7 种币种

文档

基于 API 构建。
五分钟内发出第一条消息。

一个基础 URL、Bearer 密钥、结构稳定的 JSON、幂等写入和签名 Webhook。可在下方搜索或选择任务;每个页面都提供可复制粘贴的示例。

/
  • https://api.smsmeteor.com/v1
  • 每个密钥每秒 50 次请求
  • 每次 API 请求最多 1,000 条消息

01开始

三步即可让消息送达。

  1. 1
    创建密钥进入控制面板的“开发者”页面,然后选择“创建密钥”。每个账户都有永不计费的测试密钥。
  2. 2
    POST 一条消息提供 E.164 格式的目的地、发件人、文本和幂等键。响应会包含价格。
  3. 3
    确认已送达轮询消息,或注册 Webhook,在数秒内接收 message.delivered
POST /v1/messages
import os, requests

r = requests.post(
    "https://api.smsmeteor.com/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['SMSMETEOR_KEY']}",
             "Idempotency-Key": "order-4821"},
    json={"to": "+14155550142", "from": "METEOR",
          "text": "Your order #4821 has shipped."},
)
print(r.json()["id"], r.json()["price"])
const r = await fetch("https://api.smsmeteor.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SMSMETEOR_KEY}`,
    "Idempotency-Key": "order-4821",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ to: "+14155550142", from: "METEOR",
    text: "Your order #4821 has shipped." }),
});
const { id, price } = await r.json();
$ch = curl_init('https://api.smsmeteor.com/v1/messages');
curl_setopt_array($ch, [
  CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SMSMETEOR_KEY'),
    'Idempotency-Key: order-4821', 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode(['to' => '+14155550142',
    'from' => 'METEOR', 'text' => 'Your order #4821 has shipped.']),
]);
$msg = json_decode(curl_exec($ch), true);
curl https://api.smsmeteor.com/v1/messages \
  -H "Authorization: Bearer $SMSMETEOR_KEY" \
  -H "Idempotency-Key: order-4821" \
  -d to="+14155550142" \
  -d from="METEOR" \
  -d text="Your order #4821 has shipped."

02按任务

您想做什么?

03接口范围

六个端点,一个基础 URL。

方法路径用途
POST/v1/messages发送一条消息参考
POST/v1/messages/batch最多发送 1,000 条消息参考
GET/v1/messages/{id}状态、时间戳、价格和运营商代码参考
GET/v1/messages列出并筛选,游标分页参考
GET/v1/rates公开费率表,查询全部或单个国家/地区参考
GET/v1/balance余额、待确认充值和低余额阈值参考

04概念

六个概念涵盖整个 API。

身份验证

Bearer 密钥的权限可限定为 sendread 或两者,并可选择限制 IP。测试密钥只验证和计价,不实际发送。

Authorization: Bearer sk_live_…详情

幂等性

24 小时内使用相同密钥和负载,会返回原始响应。重试绝不会重复发送。

Idempotency-Key: order-4821详情

状态

状态只会向前推进。在 sent 时计费;rejected 永不收费;有效期为 48 小时。

排队中已发送已送达失败

详情

速率限制

每个密钥每秒 50 次请求。超过后返回 429Retry-After。发送量较大时应使用批量接口,而不是增加密钥。

X-RateLimit-Remaining: 47详情

错误

统一的 JSON 结构、稳定的 code、易读说明和出错的 field。遇到 429 和 5xx 时重试;遇到 4xx 时修正请求。

{ "error": { "code": "invalid_number" } }详情

价格

每个响应都包含来自公开费率表的消息价格。无套餐、无分级,与控制面板相同。

"price": "0.0084", "currency": "USD"费率表

05资源

文件、状态与人工支持。