为你的系统而做，
不只是为控制台

发布于 2026 年 10 月 4 日 · HantarSMS

验证码和通知类短信即时发出

3 个号码以内的请求，现在一受理就直接提交给运营商，不再排在群发任务后面等。验证码、找回密码、订单确认都是这种情况：一个号码，对面有人在等。

API 文档的验证码一节写了接入要点：验证码短信控制在一段以内、带上 Idempotency-Key 让重试不会发两次、为什么应该给用户「重新发送」按钮而不是程序自动重试。

按你的流量调整发送频率

每把密钥默认每分钟 60 次发送请求，适合批量发送。注册、登录这类流量没法合并成批，高峰可能更高。把你预计的高峰告诉我们（WhatsApp），我们会为你的账号调高，最高每分钟 1,000 次。

对账算得清楚

• 每张单都会返回 refunded_cent（已退金额），和 cost_cent 放在一起。有号码被拒收退款时，这张单实际花费 = cost_cent − refunded_cent，查单和列表接口都有。
• 时间格式写清楚了。API 返回的所有时间都是 UTC，文档现在明确写出每种格式，不会再有人差 8 小时。
• 逐号码的失败原因是英文说明，文档里的示例就是真实返回的文字，你记录下来的和你在文档里读到的一致。

一分钟内发出第一条

在控制台生成 API 密钥后，下面会直接出现一条测试命令，新密钥和你自己的手机号都已经填好。复制到终端运行，你的手机就会收到一条真实短信。返回 201 和一个单号，就说明接通了。

文档说的就是接口做的

我们把 API 文档里的每一条承诺都和真实接口逐条核对了一遍：每个示例请求、每个返回字段、每个错误代码和 HTTP 状态、每个数量上限。这些核对现在都是自动测试，每次改代码都会跑，文档和接口不可能悄悄对不上。

安全

• API 密钥只以哈希形式保存，可以随时吊销，一个账号可以有多把（测试、生产分开）。
• API 不发 CORS 头，密钥没法在浏览器网页里直接使用。

准备对接了？注册账号，在控制台「API 密钥」页生成一把密钥，运行它给你的测试命令就行。