接口列表:
接口地址: http://v.juhe.cn/sms/send
支持格式: JSON/XML
请求方式: HTTP GET/POST
请求示例: http://v.juhe.cn/sms/send?mobile=手机号码&tpl_id=短信模板ID&tpl_value=%23code%23%3D654654&key=
请求参数:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
mobile | string | 是 | 接收短信的手机号码 |
tpl_id | int | 是 | 短信模板ID,请参考个人中心短信模板设置 |
tpl_value | string | 是 | 变量名和变量值对,如:#code#=431515,整串值需要urlencode,比如正确结果为:%23code%23%3d431515。如果你的变量名或者变量值中带有#&=中的任意一个特殊符号,请先分别进行utf-8 urlencode编码后再传递,详细说明> |
key | string | 是 | 在个人中心->我的数据,接口名称上方查看 |
ext | string | 否 | 扩展码,9位以内的数字,具体模板支持的长度可以提前咨询客服 |
dtype | string | 否 | 返回数据的格式,xml或json,默认json |
返回字段:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 |
JSON返回示例:
/****失败示例**/ { "reason": "错误的短信模板ID,请通过后台确认!!!", "result": [], "error_code": 205402 } /****成功示例**/ { "reason": "短信发送成功", "result": { "count": 1, /*发送数量*/ "fee": 1, /*扣除条数*/ "sid": "23d6bc4913614919a823271d820662af" /*短信ID*/ }, "error_code": 0 /*发送成功*/ }
XML返回示例:
备注:<font color=red>接口返回成功不代表接收成功,接口提交成功计费</font>,具体接收状态只能由运营商查询;运营商限制同1个号码同1个签名的内容1分钟内只能接收1条,10分钟3条,1小时内4条,一天20条,否则可能会被运营商屏蔽,短信api接口本身不限制发送频率,具体发送频率需要用户自行设置,只限国内手机号。请务必添加图片验证码等防恶意攻击的机制,以防短信轰炸,<font color=red>营销内容最后加回T退订,营销短信发送时间为:8:30至21:30。营销内容有防钓鱼机制,请勿单条发送,移动20条起(循环调用),联电不限制。</font>,字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字
服务级错误码参照(error_code):
错误码 | 说明 |
---|---|
205401 | 错误的手机号码 |
205402 | 错误的短信模板ID |
205403 | 网络错误,请重试 |
205404 | 发送失败,具体原因请参考返回reason |
205405 | 号码异常/同一号码发送次数过于频繁 |
205406 | 不被支持的模板 |
205407 | 批量发送号码超限 |
205408 | 批量发送库存次数不足 |
205409 | 系统繁忙,请稍后重试 |
205410 | 请求方法错误 |
系统级错误码参照:
错误码 | 说明 |
---|---|
10001 | 错误的请求KEY |
10002 | 该KEY无请求权限 |
10003 | KEY过期 |
10004 | 错误的OPENID |
10005 | 应用未审核超时,请提交认证 |
10007 | 未知的请求源 |
10008 | 被禁止的IP |
10009 | 被禁止的KEY |
10011 | 当前IP请求超过限制 |
10012 | 请求超过次数限制 |
10013 | 测试KEY超过请求限制 |
10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) |
10020 | 接口维护 |
10021 | 接口停用 |
错误码格式说明(示例:200201):
2 | 002 | 01 |
---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |
《短信API服务》资费说明:
等级 | 价格(元) | 请求次数 |
---|---|---|
发展套餐 | 1200.00 | 25000 |
高级套餐 | 10500.00 | 250000 |
会员套餐 | 20000.00 | 500000 |
其他相关内容:
内容 | 详细 |
---|---|
接口测试 | API测试工具 |
技术支持 | info@juhe.cn |
联系电话 | 0512-62391880 |
QQ交流群 | 264591694 |
在线客服QQ | 1794844675 |
商务合作QQ | 603866358 |