聚合数据

短信API服务

  • 数据类型: 生活服务
  • 接口状态: 正常
  • 已连接App的数量: 164747
  • 描述: 三网合一短信通道,验证码短信 · 系统通知 · 活动通知

接口地址: 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 在个人中心->我的数据,接口名称上方查看
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</font>,字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字符计费1条,中英文标点空格都算作一个字符,最多300字符。

服务级错误码参照(error_code):

错误码 说明
205401 错误的手机号码
205402 错误的短信模板ID
205403 网络错误,请重试
205404 发送失败,具体原因请参考返回reason
205405 号码异常/同一号码发送次数过于频繁
205406 不被支持的模板
205407 批量发送号码超限
205408 批量发送库存次数不足
205409 系统繁忙,请稍后重试

系统级错误码参照:

错误码 说明
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