跳到主要内容

单发接口

一、接口概述

本接口用于实现单条短信的发送功能，支持JSON/XML两种数据格式响应。开发者需使用POST方法提交表单数据，并妥善处理可能返回的错误码。

二、接口详情

1.接口地址

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

说明：

根据需求选择响应格式（将结尾后缀替换为json或xml）
示例：
http://sms-api.luosimao.com/v1/send.json
http://sms-api.luosimao.com/v1/send.xml

2.HTTP请求方式

POST
Header 要求：

Content-Type: application/x-www-form-urlencoded

三、请求参数

参数名	类型	必填	示例值	说明
mobile	String	是	13761428268	接收方手机号码，仅支持国内号码
message	String	是	验证码：321123【铁壳测试】	短信内容（长度≤300字），必须包含签名（【】括起的企业/产品标识）

注意事项：

签名规范：必须使用全角中括号包裹（如【公司名】）
内容限制：禁止包含敏感词，特殊符号建议使用全角字符
号码验证：系统会自动校验号码有效性

四、返回结果

1.响应字段说明

字段名	类型	必返	示例值	说明
error	Number	是	0	错误码（0表示成功，负数表示失败）
msg	String	是	ok	状态描述
batch_id	String	否	09-B0966DD4-FD28-43C3-94A8-F762B2269B72	仅当开启状态回推时返回，用于消息状态跟踪
hit	String	否	年化收益	当error=-31时返回触发的敏感词

2.响应示例

JSON格式：

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

XML格式：

<response>
  <error>-10</error>
  <msg>Auth failed.</msg>
</response>

五、错误码对照表

错误码	错误描述	解决方案
-10	验证信息失败	检查API key有效性（控制台 vs 代码配置）
-11	用户接口被禁用	联系客服解除封禁状态
-12	余额冻结	登录控制台进入【短信】→【触发发送】执行解冻操作
-20	短信余额不足	前往控制台充值
-30	短信内容为空	检查message参数是否传值
-31	存在敏感词	根据返回的hit字段修改内容
-32	缺少签名	在短信末尾添加规范签名（如：`【企业名称】`）
-33	短信超长（>300字符）	拆分内容为多条发送
-34	签名未审核	登录控制台进入【短信】→【签名管理】提交签名审核
-35	测试签名受限	更换为正式签名
-40	手机号格式错误	检查号码是否符合E.164规范（如：+86前缀）
-41	号码在黑名单	联系客服处理
-42	验证码发送频率过快	客户端增加60秒间隔限制
-50	IP不在白名单	检查控制台【安全设置】→【IP白名单】配置

一、接口概述
二、接口详情
- 1.接口地址
- 2.HTTP请求方式
三、请求参数
四、返回结果
- 1.响应字段说明
- 2.响应示例
五、错误码对照表