短信服务 API

发送单条短信

适用于发送验证码、订单通知、系统告警等具有时效性要求的触发类短信。支持 JSON 或 XML 响应格式。

接口地址 (URL)

https://sms-api.luosimao.com/v1/send.[json|xml]

请求方式

POST

Content-Type

application/x-www-form-urlencoded

鉴权方式

HTTP Basic Auth（用户名固定 api，密码为 API_KEY）

名称	类型	必须	示例值	描述
`mobile`	String	是	13761428268	目标手机号码
`message`	String	是	验证码：321123【公司名称】	短信内容。注意：末尾必须包含签名，且内容须合规。

名称	类型	示例值	描述
`error`	Number	0	错误码（0 为成功，非 0 为失败）
`msg`	String	ok	错误码对应的文本描述
`batch_id`	String	09-B0966DD4-FD28-43C3...	发送批次号。开启状态推送后，将凭此参数匹配 WebHook 状态回执（仅成功时返回）
`hit`	String	年化收益	命中的敏感词（仅当 `error` 为 -31 且触发内容拦截时返回）

Response — JSON

{
    "error": 0,
    "msg": "ok",
    "batch_id": "09-B0966DD4-FD28-43C3-94A8-F762B2269B72"
}

Response — XML

<response>
    <error>0</error>
    <msg>ok</msg>
    <batch_id>09-B0966DD4-FD28-43C3-94A8-F762B2269B72</batch_id>
</response>

如果请求失败遇到错误码，请查阅接口通用说明 - 全局错误码排查原因。