硕达通会员营销类群发短信接口文档
接口说明:客户接口部分提供http url方式的接口,根据客户需求可以提供相应接口,接口编码方式采用统一的UTF-8
第一章 发送接口
1.1 请求地址
请求地址是客户接口程序调用时请求的url地址,采用的是http post 接口,地址是
http://115.28.172.169:8888/sms.aspx 对应UTF-8
http://115.28.172.169:8888/smsGBK.aspx 对应GB2312
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
1.2参数说明
http://115.28.172.169:8888/sms.aspx
http://115.28.172.169:8888/smsGBK.aspx
参数名称 |
含义 |
说明 |
userid |
企业id |
企业ID |
account |
发送用户帐号 |
用户帐号,由系统管理员 |
password |
发送帐号密码 |
用户账号对应的密码 |
mobile |
全部被叫号码 |
发信发送的目的号码.多个号码之间用半角逗号隔开 |
content |
发送内容 |
短信的内容,内容需要UTF-8编码 |
sendTime |
定时发送时间 |
为空表示立即发送,定时发送格式2010- 10-24 09:08:10 |
action |
发送任务命令 |
设置为固定的:send |
extno |
扩展子号 |
请先询问配置的通道是否支持扩展子号,如果不支持,请填空。子号只能为数字,且最多5位数。 |
例如:
action=send&userid=12&account=账号&password=密码&mobile=15023239810,13527576163&content=内容&sendTime=&extno=
注:短信内容格式:【签名】+短信内容,例如:【硕达通】您本次的验证码是:2734
短信切不可用不正规内容随便测试,例如,您好,测试;哈哈哈哈;测试测试 等内容!
1.3返回值
在接收到客户端发送的http请求后,返回以xml的方式返回处理结果。格式为:
返回信息提示 |
说明 |
ok |
提交成功 |
用户名或密码不能为空 |
提交的用户名或密码为空 |
发送内容包含sql注入字符 |
包含sql注入字符 |
用户名或密码错误 |
表示用户名或密码错误 |
短信号码不能为空 |
提交的被叫号码为空 |
短信内容不能为空 |
发送内容为空 |
包含非法字符: |
表示检查到不允许发送的非法字符 |
对不起,您当前要发送的量大于您当前余额 |
当支付方式为预付费是,检查到账户余额不足 |
其他错误 |
其他数据库操作方面的错误 |
106短信接口备注:接口返回成功不代表接收成功,具体接收状态只能由运营商查询;运营商限制同1个号码同1个签名的内容1分钟内只能接收1条,1小时内只能接收5条,一天最多接收20条,否则可能会被运营商屏蔽,短信api接口本身不限制发送频率,具体发送频率需自行设置。
第二章 状态报告接口
2.1 请求地址
请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://115.28.172.169:8888/statusApi.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
2.2参数说明
参数名称 |
含义 |
说明 |
userid |
企业id |
企业ID |
account |
用户帐号 |
用户帐号,由系统管理员 |
password |
帐号密码 |
用户账号对应的密码 |
action |
任务名称 |
设置为固定的:query |
例如:
action=query&userid=12&account=账号&password=密码
2.3返回值
2.4错误返回值——状态报告请求错误返回格式及对应值
1:用户名或密码不能为空
2:用户名或密码错误
3:该用户不允许查看状态报告
4:参数不正确
第三章 上行接口
3.1 请求地址
请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://115.28.172.169:8888/callApi.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
3.2参数说明
参数名称 |
含义 |
说明 |
userid |
企业id |
企业ID |
account |
用户帐号 |
用户帐号,由系统管理员 |
password |
帐号密码 |
用户账号对应的密码 |
action |
任务名称 |
设置为固定的:query |
例如:
action=query&userid=12&account=账号&password=密码
3.3返回值
<callbox>
<content>你好,我不需要content>---------上行内容
callbox>
<callbox>
<content>你好,本次活动路线是怎么的content>
callbox>
3.4错误返回值——回复请求错误返回格式及对应值
1:用户名或密码不能为空
2:用户名或密码错误
3:该用户不允许查看状态报告
4:参数不正确