为什么用 Webhook
轮询 API 也可以,但 Webhook 能在几秒内送达每条短信,无需您的代码反复查询。
设置方法
打开 API 密钥页面,输入公网域名下的 HTTPS 地址并保存。签名密钥只显示一次:请将它与服务器的其他密钥一起保存。
您会收到什么
一个带 JSON 正文的 POST 请求:事件为 sms.received,data 中包含租用 id、手机号码、发送方、短信全文、识别出的验证码和接收时间。
校验每个请求
读取 X-PortSMS-Signature 请求头,用您的密钥计算 "t.body" 的 HMAC-SHA256,并以恒定时间比较与 v1 是否一致。拒绝 t 超过 5 分钟的请求。
快速响应
存好短信后立即返回 2xx 状态码,耗时的工作之后再做。其他响应会被重试最多 8 次。