post提交时候 头信息采用默认Content-Type=application/x-www-form-urlencoded
第一章 发送接口
1.1 请求地址
请求地址是客户接口程序调用时请求的url地址,采用的是http post 接口,地址是
http://客户端地址/p2p.aspx 对应UTF-8
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
1.2参数说明
参数名称 | 含义 | 说明 |
userid | 企业id | 企业ID |
account | 发送用户帐号 | 用户帐号,由系统管理员 |
password | 发送帐号密码 | 用户账号对应的密码 |
mobileContentList | 号码文件列表 | 号码和内容间用tab制表符隔开。每行一个号码和内容。如果内容里面带有tab,使用/t替换。内容里面有回车换行,使用/r/n替换 |
sendTime | 定时发送时间 | 为空表示立即发送,定时发送格式2010-10-24 09:08:10 |
action | 发送任务命令 | 设置为固定的:send |
extno | 扩展子号 | 请先询问配置的通道是否支持扩展子号,如果不支持,请填空。子号只能为数字,且最多10位数。 |
例如:
p2p.aspx?action=send&userid=编号&account=账号&password=密码&mobileContentList=号码内容列表&sendTime=&extno=
号码内容列表格式为
号码+tab+内容
号码+tab+内容
号码+tab+内容
号码+tab+内容
其中内容如果包含tab,则需要使用/t替换
如果内容中包含回车换行,则需要使用/r/n替换
注意:由于接口是按字符数计费,当特殊符号替换后,会增加短信长度,请注意短信字数,短信内容尽量不适用特殊字符。
1.3返回值
在接收到客户端发送的http请求后,返回以xml的方式返回处理结果。格式为:
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<returnstatus>status</returnstatus> ---------- 返回状态值:成功返回Success 失败返回:Faild
<message>message</message> ---------- 返回信息:见下表
<remainpoint> remainpoint</remainpoint> ---------- 返回余额
<taskID>taskID</taskID> ----------- 返回本次任务的序列ID
<successCounts>successCounts</successCounts> --成功短信数:当成功后返回提交成功短信数
</returnsms>
返回信息提示 | 说明 |
ok | 提交成功 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
发送内容包含sql注入字符 | 包含sql注入字符 |
用户名或密码错误 | 表示用户名或密码错误 |
短信号码不能为空 | 提交的被叫号码为空 |
短信内容不能为空 | 发送内容为空 |
包含非法字符: | 表示检查到不允许发送的非法字符 |
对不起,您当前要发送的量大于您当前余额 | 当支付方式为预付费是,检查到账户余额不足 |
其他错误 | 其他数据库操作方面的错误 |