短信发送
接口凭据
请立即复制，该凭据仅显示一次
| 名称 / 标识 | 状态 | 创建时间 | 过期时间 | IP 白名单 | 操作 |
|---|
尚无凭据，创建后即可通过接口发送短信。
登录日志
| 时间（本地） | 结果 | 来源 IP | 请求 URL | 用户名 | 请求方法 |
|---|
该日期暂无登录记录。
短信发送日志
| 时间（本地） | 操作 | 调用身份 | 结果 | 请求流水与详情 |
|---|
该日期暂无短信发送记录。
接口接入
发送相同内容短信
调用来源必须命中该凭据的 IP 白名单；白名单留空表示不限制。HTTPS 反代部署需正确配置可信代理。
POST /api/v1/sms/send
Authorization: Bearer <YOUR_API_TOKEN>
Content-Type: application/json
{
"mobile": "13800138000,13900139000",
"content": "您有新的待审批单，请及时处理。",
"svrtype": "OA",
"custid": "oa_approval_000001"
}内容使用 UTF-8 明文，服务自动添加签名并完成供应商编码。msgid 始终返回字符串。custid 用于业务追踪，不提供幂等去重。
| 接口路径 | 用途 | 请求体 |
|---|---|---|
| /api/v1/sms/send | 相同内容群发 | mobile、content 等 |
| /api/v1/sms/single | 单号码发送 | 同上，限一个号码 |
| /api/v1/sms/multi | 个性化群发 | multimt 数组，最多 100 条 |
| /api/v1/sms/balance | 查询余额 | {} |
| /api/v1/sms/reports | 拉取送达回执 | {"retsize":100} |
| /api/v1/sms/messages | 拉取上行短信 | {"retsize":100} |
回执与上行属于消费式拉取，调用方需持久化返回数据。服务不在后台自动轮询。供应商超时、异常响应时结果可能已生效，请先核对后再决定是否重试。