三网短信通知类(需要模板)
服务商: 昆明秀派科技有限公司
电话: 400-998-8033
QQ: 3007663665
邮箱: services@showapi.com
提交短信接收方的手机号(国内用户)、模板编号和对应模板中的参数值,短信接口会根据模板内容和参数值,组装成完整的短信发送给接收方.
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|---|---|---|---|---|
mobile | String | 是 | 手机号码.每次只能发送一个号码 | ||
content | String |
{"name":"某某","code":"123456"}
|
否 | 使用json格式对应模板的键值对,动态内容使用,使用UTF-8编码 (70字符含自定义签名,超过70,请传big_msg=1参数,超过70字符按67个字符算一条短信)最多400个字符 强调下,json中的key和value如果不是数字,则必须用双引号包裹,不要用单引号. | |
tNum | String |
T150513000036
|
否 | 短信模板ID,(请按照示例,建立自己的模板库)否则将无法使用; | |
big_msg | String | 否 | 传1或者不传;超过70个字符的短信传big_msg=1;(如果big_msg=1不验证短信长度,否则发送失败; 如果big_msg==null || !=1就要开启长度验证) | ||
tCode | String | 否 | 模板自定义code,每个用户下唯一 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ret_code | String |
0
|
0为提交到队列成功,其他失败。 |
remark | String |
ok
|
描述信息 |
taskID | String |
12345
|
任务ID |
successCounts | String |
1
|
计费长度 |
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"ret_code": "0",
"remark": "提交成功!",
"taskID": "12345",
"successCounts": "1"
}
}
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code | int | 0 | 查看错误码 |
showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
状态码 | 描述 |
---|---|
0 | 成功 |
-1 | 系统调用错误 |
-2 | 可调用次数或金额为0 |
-3 | 读取超时 |
-4 | 服务端返回数据解析错误 |
-5 | 后端服务器DNS解析错误 |
-6 | 服务不存在或未上线 |
-7 | API创建者的网关资源不足 |
-3 | 读取超时 |
-1000 | 系统维护 |
-1002 | showapi_appid字段必传 |
-1003 | showapi_sign字段必传 |
-1004 | 签名sign验证有误 |
-1005 | showapi_timestamp无效 |
-1006 | app无权限调用接口 |
-1007 | 没有订购套餐 |
-1008 | 服务商关闭对您的调用权限 |
-1009 | 调用频率受限 |
-1010 | 找不到您的应用 |
-1011 | 子授权app_child_id无效 |
-1012 | 子授权已过期或失效 |
-1013 | 子授权ip受限 |
-1014 | token权限无效 |