参数免费短信群发平台

杭州三体科技短信平台接口说明Version2.
51普通短信发送41.
1接口地址41.
2请求参数41.
3请求响应51.
3.
1格式说明51.
3.
2示例51.
3.
3响应状态值说明62短信状态报告通知接口72.
1接口地址82.
2请求参数82.
3请求响应93短信状态报告查询接口103.
1接口地址103.
2请求参数103.
3请求响应113.
3.
1格式说明113.
3.
2示例114上行短信查询接口124.
1接口地址124.
2请求参数124.
3请求响应124.
3.
1格式说明124.
3.
1示例135上行短信通知接口145.
1接口地址145.
2请求参数145.
3请求响应156余额查询接口156.
1接口地址156.
2参数定义166.
3请求响应166.
4响应状态值说明167普通短信发送(扩展码)177.
1接口地址177.
2请求参数177.
3请求响应187.
3.
1格式说明187.
3.
2示例187.
3.
3响应状态值说明19版本修订历史项目日期修订内容备注技术支持:莫智洲qq:40919628普通短信发送用户通过HTTP的GET/POST方式提交短信发送请求.
编码采用UTF-8编码.
接口地址URL地址为:http://sms.
santiyun.
com/extMt.
php请求参数序号参数说明1appId必填参数.
应用ID号2modeId必填参数.
模板ID,需后台审核通过,每种短信内容有固定的模板ID3vars选填参数.
若短信模板中有变量,则须传此参数.
例:"123|789",参数间用英文竖线分割.
UTF-8编码,若vars包含超链接或者特殊字符,则需要对vars做urlencode编码4mobile必填参数.
11位标准手机号码.
若为多个号码用英文逗号分隔,最多支持500个手机号.
5sendTime选填参数.
发送时间.
若不传,视为立即发送;若传值,则会在sendTime表示的时间点开始发送.
格式为:yyyyMMddHHmmss如:201611231430226notifyUrl选填参数.
状态通知地址.
若传值,则按照传入notifyUrl做状态通知.
需作Urlencode后传入7sign必填参数.
用户签名.
(appKey+appId+mobile)生成MD5转小写字母,appKey在平台获取.
8extCode选填,用户自定义扩展码,必须为1-3位纯数字接口调用例子:http://sms.
santiyun.
com/extMt.
phpappId=12&modeId=1000001&vars=162|736&mobile=13599834657,13616555328,13615810198,13506876957,13905710571,13963283745,746613,18658818870,15305710571,13205710571&sign=06b5c5d639995b4ea8a4f65bb5590fb6&extCode=123请求响应返回json格式响应报文,参数定义如下:格式说明参数名父节点类型选取原则说明code-int必选一级返回码.
0为成功,其他响应码为失败msg-String必选描述信息.
rets-int可选发送详情列表,code=0时展示respCoderetsint可选二级返回码.
0为成功,其他响应码为失败mobileretsString可选手机号码sendIdretsString可选订单号示例提交成功{"code":0,"msg":"提交成功","rets":[{"respCode":0,"mobile":"13485769883","sendId":"123"},{"respCode":0,"mobile":"13480983746","sendId":"456"},……]}提交失败{"code":104,"msg":"模板不存在"}响应状态值说明一级返回码(code)说明代码说明0提交成功101必填项为空102短信长度不能超过670字符长度103应用不存在104模板不存在105模板未审核106短信余额不足107客户账号停用108签名验证失败109无效手机号110系统异常111手机号数量超过上限112时间戳相差过大113设定的发送时间不合法114IP权鉴不通过115商户ID不存在116商户名不合法117登录帐号不合法118代理商不存在119代理商审核未通过120应用与短信模版不对应二级返回码(respCode)说明返回码说明0提交成功201黑名单号码202无效号码203发送次数超过限制短信状态报告通知接口短信发送成功或者失败,将通过此接口通知发送结果.
注:本接口需要申请开通,否则不生效.
接口地址通知地址由代理商提供,配置到账号中,若发送短信接口传入notifyUrl,则以传入的notifyUrl为准.
请求参数请求方式为HTTPPOST报文格式为JSON,报文头"content-type":"application/json"序号父节点参数类型说明1-signstring签名,规则为md5(appkey+report)转小写字母,其中report见参数2中的report2-reportstring报告内容,json数组序列化为字符串格式3report数组元素sendIdlong必填参数,短信订单号4report数组元素mobilestring必填参数.
手机号码5report数组元素statusint必填参数.
短信状态,2=成功,3=失败6report数组元素sendTimestring必填参数.
状态报告时间,yyyy-MM-ddHH:mm:ss7report数组元素reportStatusstring必填参数.
原始错误码示例:{"sign":"d78d8e8f80a02887b8c7363bc","report":"[{\"sendId\":1523423990003390,\"status\":2,\"sendTime\":\"2016-12-2313:45:53\",\"mobile\":\"13599876537\",\"reportStatus\":\"DELIVRD\"},{\"sendId\":159300388376666340,\"status\":3,\"sendTime\":\"20161223134552\",\"mobile\":\"13299872237\",\"reportStatus\":\"DELIVRD\"},……]"}请求响应成功返回SUCCESS失败返回FAIL,若返回非SUCCESS,则会继续通知,最多通知10次处理成功SUCCESS处理失败FAIL短信状态报告查询接口本接口需要申请开通才能使用,查询过的状态报告将不会再被查询到,查询有效期为7天,即只能查询到7天内的状态报告.
接口地址http://query.
santiyun.
com/query.
php请求参数请求方式为HTTPPOST序号参数说明1appId必填参数.
应用ID号2sign必填参数.
签名appKey+appIdMD5小写3size选填参数.
每次查询的记录条数上限,默认值为100,最大支持1000接口调用示例:http://query.
santiyun.
com/query.
phpappId=12&sign=06b5c5d639995b4ea8a4f65bb5590fb6&size=500请求响应格式说明返回json格式响应报文,参数定义如下:序号父节点参数类型说明1-codeint查询状态码code=0为查询成功,code=其他值为查询失败,rets节点不出现2-msgstring查询状态描述3rets数组sendIdlong短信订单号,发送接口返回的订单号4rets数组mobilestring手机号码5rets数组statusint短信状态,2=成功,3=失败6rets数组sendTimestring状态报告时间,yyyy-MM-ddHH:mm:ss7rets数组reportStatusstring原始错误码示例返回json格式响应报文,参数定义如下:{"code":0,"msg":"查询成功","rets":[{"sendId":1,"status":2,"sendTime":"2017-01-1622:34:11","reportStatus":"DELIVRD","mobile":"13588143705"},{"sendId":2,"status":2,"sendTime":"2017-01-1622:35:48","reportStatus":"DELIVRD","mobile":"13588143705"}]}上行短信查询接口本接口需要申请开通才能查询到上行短信数据,查询过的上行短信将不会再被查询到,查询有效期为7天,即只能查询到7天内的上行短信.
接口地址http://query.
santiyun.
com/queryMo.
php请求参数序号参数说明1appId必填参数.
应用ID号2sign必填参数.
签名appKey+appIdMD5小写3size选填参数.
每次查询的记录条数上限,默认值为100,最大支持1000接口调用示例:http://query.
santiyun.
com/queryMo.
phpappId=12&sign=06b5c5d639995b4ea8a4f65bb5590fb6&size=500请求响应格式说明返回json格式响应报文,参数定义如下:序号父节点参数类型说明1-codeint查询状态码code=0为查询成功,code=其他值为查询失败,rets节点不出现2-msgstring查询状态描述3rets数组sendIdlong短信订单号,发送短信的订单号4rets数组mobilestring手机号码5rets数组contentstring上行短信内容6rets数组receiveTimestring回复短信时间,yyyy-MM-ddHH:mm:ss7rets数组destIdstring短信通道号示例{"code":0,"msg":"查询成功","rets":[{"content":"124443","sendId":0,"receiveTime":"2017-01-1622:02:28","destId":"10690000010","mobile":"13588143705"},{"content":"124443","sendId":0,"receiveTime":"2017-01-1622:21:23","destId":"10690000010","mobile":"13588143705"}]}上行短信通知接口本接口需要申请开通,否则不生效.
接口地址通知地址由代理商提供,配置到账户中.
请求参数请求方式为HTTPPOST报文格式为JSON,报文头"content-type":"application/json"序号父节点参数类型说明1-signstring签名,规则为md5(appkey+report)转小写字母,其中report见参数2中的report2-reportstring报告内容,json数组序列化为字符串格式3report数组contentstring用户回复内容4report数组sendIdlong短信订单号,用户主动上行的为05report数组receiveTimestring回复时间,格式为yyyy-MM-ddHH:mm:ss6report数组destIdstring用户接受短信通道号7report数组mobilestring手机号示例:{"sign":"bbb3b2bbb8b9c0d80df1772fab2","report":"[{\"content\":\"124443\",\"sendId\":15009494884774774740,\"receiveTime\":\"2017-01-1622:02:28\",\"destId\":\"10690000010\",\"mobile\":\"13588143705\"},……]"}请求响应成功返回SUCCESS失败返回FAIL,若返回非SUCCESS,则会继续通知,最多通知10次处理成功SUCCESS处理失败FAIL余额查询接口接口地址http://sms.
santiyun.
com/sms.
php参数定义序号参数说明1app_id必填参数.
应用ID号2sign必填参数.
签名app_key+app_idMD5小写3type必填参数.
固定值bl接口调用例子:http://sms.
santiyun.
com/sms.
phpapp_id=12345&sign=testsign&type=bl请求响应code为获取状态,balance是用户余额.
响应状态值说明代码说明0成功101应用不存在108签名验证失败107客户账号停用110系统错误