身份验证
Bearer 密钥的权限可限定为 send、read 或两者,并可选择限制 IP。测试密钥只验证和计价,不实际发送。
Authorization: Bearer sk_live_…详情文档
一个基础 URL、Bearer 密钥、结构稳定的 JSON、幂等写入和签名 Webhook。可在下方搜索或选择任务;每个页面都提供可复制粘贴的示例。
01开始
message.delivered。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接口范围
04概念
Bearer 密钥的权限可限定为 send、read 或两者,并可选择限制 IP。测试密钥只验证和计价,不实际发送。
Authorization: Bearer sk_live_…详情24 小时内使用相同密钥和负载,会返回原始响应。重试绝不会重复发送。
Idempotency-Key: order-4821详情状态只会向前推进。在 sent 时计费;rejected 永不收费;有效期为 48 小时。
排队中已发送已送达失败
详情每个密钥每秒 50 次请求。超过后返回 429 和 Retry-After。发送量较大时应使用批量接口,而不是增加密钥。
X-RateLimit-Remaining: 47详情统一的 JSON 结构、稳定的 code、易读说明和出错的 field。遇到 429 和 5xx 时重试;遇到 4xx 时修正请求。
{ "error": { "code": "invalid_number" } }详情每个响应都包含来自公开费率表的消息价格。无套餐、无分级,与控制面板相同。
"price": "0.0084", "currency": "USD"费率表05资源