一条短信的流程
发送后,每个收件人先进入队列并扣费(queued),然后提交到运营商通道(sent)。之后运营商会报告手机是否收到(delivered)或未收到(failed)。
报告何时到达
大多数报告会在几秒到几分钟内到达。部分运营商报告较晚或不报告;没有报告的短信会保持 sent 状态。
退款
发送失败的短信会自动退款到您的余额。您可以在余额记录中查看每笔退款及对应的短信 id。
接收 Webhook
在 API 密钥页面添加一个 https 地址。当短信送达或失败时,我们会 POST 一个 JSON 请求体,包含短信 id、号码、状态、价格和您的 ref。请返回任意 2xx 状态码;否则我们会在约两小时内最多重试 8 次。
校验签名
每个 Webhook 都带有 X-PortSMS-Signature: t=<time>,v1=<hex>。用您的签名密钥对文本 t.body 计算 HMAC-SHA256,并与 v1 比较。请拒绝超过五分钟的请求,防止旧请求被重放。