发送短信接口

暂无描述

接口状态

已完成

接口URL

http://127.0.0.1:9990/sms/json/submit

请求方式

POST

Content-Type

json

请求Header参数

参数名	示例值	参数类型	是否必填	参数描述
Authorization	eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjRkNDc4MmY0LTRjNDItNGRkZC1iOTg1LTYxMTJjZDg0MzBhMSJ9.OI2locw-kgsBXgX53SKuP9K3_cEo46HtLyWTh35gO9qN3za2SR8THLpb5uRhmGiqvLTyz4RwlxeFRNS3JX8e7w	String	是	TOKEN头

请求Body参数

{
    "mobile": "13532423512",
    "content": "短信内容",
    "inputSubCode": "1069075",
    "isTemplate": 1,
    "templateId": null,
    "sendTiming": null
}

参数名	示例值	参数类型	是否必填	参数描述
mobile	18945412512,13526121321	String	是	下发短信手机号,支持单个或多个手机号下发,根据账号并发限制,详情请咨询管理员,多个号码用英文,号分割。(注意:国际版需+国家编码如+8613551121232 最大长度为20,超过则发送失败。)国内版本手机号长度限制11位。
content	短信内容	String	是	短信下发内容,短信内容格式:签名+内容,不加签名容易导致下发失败,签名需要提前报备,短信内容长度最大不能超过500字。签名格式说明:国际版短信签名格式[签名] ,国内版短信签名格式【签名】（注意:模板短信签名不需要传,只需要传模板变量内容如模板有2个变量则每一个变量内容用\|隔开,严格按照变量顺序来,每一个变量内容长度必须在25个字符以内。）
inputSubCode	1069075	String	是	下发接入码,不能超过21位
isTemplate	1	Integer	是	是否模板短信 0 是 1不是
templateId	-	Number	是	模板ID,不是模板短信传null
sendTiming	-	Date	是	定时发送时间,时间轴格式不是定时短信传null值即可

认证方式

noauth

成功响应示例

{
    "msg": "提交成功",
    "code": 200,
    "data": [
        {
            "msgBatchNo": "1522845942394691584",
            "mobile": "19945412512",
            "clientIp": "192.168.0.109",
            "result": 0
        }
    ]
}

参数名	示例值	参数类型	参数描述
msg	提交成功	String	状态
code	200	Number	状态码
data	-	Object	返回数据
data.msgBatchNo	1522845942394691584	String	消息ID,短信提交完成返回的消息唯一ID,短信回执报告需要这个消息ID进行匹配
data.mobile	19945412512	String	下发手机号
data.clientIp	192.168.0.109	String	提交的IP
data.result	-	Integer	发送状态码 0=提交成功 131=手机号码格式不正确

错误响应示例

{
    "msg": "错误的原发号码,接入码错误",
    "code": 134
}

参数名	示例值	参数类型	参数描述
msg	错误的原发号码,接入码错误	String	接入码错误,请检查接入码是否正确
code	134	Integer	状态码

{
    "msg": "手机号下发超限",
    "code": 137
}

参数名	示例值	参数类型	参数描述
msg	手机号下发超限	String	手机号码数量超过设置的阈值
code	137	Integer	状态码

{
    "msg": "每秒并发超限",
    "code": 5
}

参数名	示例值	参数类型	参数描述
msg	每秒并发超限	String	并发超限
code	5	Integer	状态码

{
    "msg": "错误描述",
    "code": 500
}

参数名	示例值	参数类型	参数描述
msg	错误描述	String	接口返回的错误原因
code	500	Integer	状态码

作者：smswg 创建时间：2023-06-09 15:14
最后编辑：smswg 更新时间：2025-06-27 15:14