API文档使用说明

1.发送短信接口

接口描述

单号码短信发送,即每次只能发送给一个手机号码,短信内容不能超过1000个字符

请求地址

https://域名/sms/send.do

注: 必须是post请求,个人开发者域名使用sms_developer.zhenzikj.com,企业开发者域名使用sms.zhenzikj.com

注: 测试发送短信内容不要使用"你好"或"12132"全数字形式,这种短信内容没有具体的意义,可能会被运营商屏蔽

请求参数

参数名称 必选 类型 描述
appId string 应用id,可通过用户中心,应用详情查看
appSecret string 应用秘钥,可通过用户中心,应用详情查看
message string 短信内容,最长不超过1000字符
messageId string 短信的唯一标识, 不能重复。用于开发者需要返回发送状态报告,需要在用户中心-应用详情中设置回调地址
number string 短信接收号码,只能是单一号码
当开发者设置了messageId时,必须同时设置回调地址,如下图:

返回结果

返回结果是json格式的字符串, code: 发送状态,0为成功。非0为发送失败,可从data中查看错误信息

			{
			    "code":0,
			    "data":"发送成功"
			}
			

错误代码表

错误码 原因 解决方案
100 参数格式错误 检查请求参数是否为空, 或手机号码格式错误
101 短信内容超过1000字 短信内容过长,请筛检或分多次发送
105 appId错误或应用不存在 请联系工作人员申请应用或检查appId是否输入错误
106 应用被禁止 请联系工作人员查看原因
107 ip错误 如果设置了ip白名单,系统会检查请求服务器的ip地址,已确定是否为安全的来源访问
108 短信余额不足 需要到用户中心进行充值
109 今日发送超过限额 如果设置了日发送数量,则每个接收号码不得超过这个数量
110 应用秘钥(AppSecret)错误 检查AppSecret是否输入错误,或是否已在用户中心进行了秘钥重置
111 账号不存在 请联系工作人员申请账号
1000 系统位置错误 请联系工作人员或技术人员检查原因

2.查询短信余额

接口描述

查询当前应用对应账户下的短信剩余条数

注: 如果一个账户下存在多个应用,可通过任一应用查看账户余额

请求地址

https://域名/account/balance.do

注: 必须是post请求,个人开发者域名使用sms_developer.zhenzikj.com,企业开发者域名使用sms.zhenzikj.com

请求参数

参数名称 必选 类型 描述
appId string 应用id,可通过用户中心,应用详情查看
appSecret string 应用秘钥,可通过用户中心,应用详情查看

返回结果

返回结果是json格式的字符串, code: 发送状态,0为成功。非0为发送失败,可从data中查看错误信息

			{
			    "code":0,
			    "data":"发送成功"
			}
			

返回结果是json格式的字符串, code: 查询状态,0为成功,data为剩余短信条数。非0为查询失败,可从data中查看错误信息

错误代码表

错误码 原因 解决方案
100 参数格式错误 检查请求参数是否为空
105 appId错误或应用不存在 请联系工作人员申请应用或检查appId是否输入错误
106 应用被禁止 请联系工作人员查看原因
107 ip错误 如果设置了ip白名单,系统会检查请求服务器的ip地址,已确定是否为安全的来源访问
110 应用秘钥(AppSecret)错误 检查AppSecret是否输入错误,或是否已在用户中心进行了秘钥重置
1000 系统位置错误 请联系工作人员或技术人员检查原因

3.查询短信

接口描述

根据messageId查询已发送短信

请求地址

https://域名/smslog/findSmsByMessageId.do

注: 必须是post请求,个人开发者域名使用sms_developer.zhenzikj.com,企业开发者域名使用sms.zhenzikj.com

请求参数

参数名称 必选 类型 描述
appId string 应用id,可通过用户中心,应用详情查看
appSecret string 应用秘钥,可通过用户中心,应用详情查看
messageId string 信息id,对应发送短信接口的messageId字段

返回结果

返回结果是json格式的字符串, code: 发送状态,0为成功。非0为发送失败,可从data中查看错误信息

			{
			    "code":0,
			    "data":{}
			}
			

返回结果是json格式的字符串, code: 查询状态,0为成功,data短信信息的json字符串

短信验证码接口平台 Copyright ©北京榛子科技有限公司
地址: 北京市海淀区上地中关村软件园1期23号楼二层 TEL:185 1846 3823 QQ: 1965891378
站点地图 公司主营:短信验证码 短信接口 短信平台