营销短信接口调用说明


API文档介绍

1. 参数说明

向指定手机号码发送短信。使用前需要在银栗子后台添加应用。测试时请直接使用正式环境HTTP请求地址。

功能:发送营销短信

地址:http://www.ylzsms.com/api/send

备注:采用post方法提交请求

参数名 类型 简介 描述
sid string 商户SID 32位,非空。由系统开户设置,系统分配。不允许为空
appkey string 应用码 16位,非空。MD5格式,在开发者中心,应用栏目查看
content string 发送内容 非空。短信内容,长度不可以超过500字,内容不得包含非法词,否则会发送失败,返回1007代码。
mobiles string 手机号 非空。支持移动,联通,电信混合提交;多个号码中间采用半角逗号分隔,每个包最大支持1000个号码。例:13500000000,13000000000,15100000000
time string 时间戳 由当前时间生成的时间戳,纯数字,如1458706009,PHP中可以用time()函数生成。
md5 string 校验码 32位,非空。生成格式MD5(sid+appkey +token+time),Md5是为了安全做的校验.其中sid,appkey,time都为以上参数,token在主控制面板可以通过手机验证获取:如图,复制显示的token即可。
2. 返回说明

返回结果以json形式返回,详细参数及示例如下。

参数名 描述
code 返回代码
mid 查询编码
3. 接口返回值

API调用后,返回的值,对应的说明如下。

返回代码 字符码 返回描述
0000 SUCCESS 发送成功
1000 SID_ERROR 商户错误或不存在
1001 APP_ERROR 应用错误或不存在
1002 APP_NOT_AUTH 应用未审核通过
1003 REQUIRED_PARAM_MISS 缺失必要请求参数
1004 SIGN_VERIFY_ERROR 签名验证错误
1005 BALANCE_INSUFFICIENT 商户余额不足
1006 CONTENT_LEN_ERROR 短信内容长度不正确
1007 CONTENT_ILLEGAL 短信内容包含非法词
1008 INVALID_RECEIVED 接收号码有问题
1009 PARAM_UNSET 短信内容参数缺失
1010 TEMPLATE_ERROR 短信模板未审核或不存在
1011 TEMPLATE_NOT_AUTH 短信模板未授权
4. 示例代码
5. 文档下载