API

每条线路免费，不限时长。无企业版，无按席位定价，无需销售电话。

基本 URL

https://api.hushsms.com

认证

身份验证

将您的线路令牌作为 Bearer 凭据传递。令牌仅限于单条线路，可在面板中轮换。

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

参考

端点

GET/v1/lines

列出您令牌上的线路。返回号码、国家/地区、期限和到期日。

POST/v1/lines

开通一条线路。请求体包含国家/地区、线路类型、期限和池。返回加密货币发票。

GET/v1/lines/{id}/messages

线路的入站短信，最新在前。消息正文在保留期后会被删除。

POST/v1/lines/{id}/messages

发送出站短信。包含在每种期限中。

GET/v1/catalog

实时国家/地区库存、各服务兼容性和当前价格。无需认证。

DELETE/v1/lines/{id}

提前释放线路。月度期限无退款；六个月以上按比例退款。

推送

Webhooks

每条入站消息在到达后一秒钟内 POST 到您的端点，并使用 HMAC-SHA256 签名。

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

机器

适用于 AI 代理

机器可读目录位于 https://hushsms.com/v1/catalog/。它返回实时国家库存、各服务兼容性和当前定价，格式为 JSON，无需身份验证。

Open the catalog

它返回实时国家/地区库存、各服务兼容性（包括不工作的服务）、当前价格（含所有乘数）以及数据保留表。无需密钥，没有值得一提的速率限制，CORS 是开放的。如果您正在构建需要电话号码的代理，这是要读取的端点。

整个网站的纯文本摘要位于 /llms.txt，完整语料库位于 /llms-full.txt。

作为可调用合约的目录

纯文本语料库使目录可读，但不可调用：即使代理阅读了每个字，仍然不知道请求结构、国家/地区缩写的枚举或服务器忽略的字段，因此它只能描述无法购买的数字。内容策略的局限性就在这里。

/openapi.json 弥补了这一差距——一个 OpenAPI 3.1 文档，涵盖三个公开的、无需认证的端点（读取目录、创建订单、轮询订单），其中国家/地区、期限和池枚举根据处理程序验证所用的同一目录生成。它还在文档头部声明为 rel="service-desc"，因此查找服务描述的客户端无需告知即可找到。

打开 OpenAPI 描述

来源

此页面上的编号方案数据——拨号代码、国家号码长度、前缀和移动号码范围——来自 ITU-T E.164 系列。库存、定价和实测成功率均为我们自身数据，并已相应标注。

ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Union国家呼叫代码、国家有效号码长度、号码结构
ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Union各国家编号规划、移动号段、长途前缀

编号方案验证于 2026年8月1日

获取号码联系我们