- 开发引导
- API文档
- 客户发送接口
- 客户余额及已发送查询
- 客户非法关键词查询
- 客户状态报告接口
- 客户上行接口
- 代码示例
- Php代码示例
- Java代码示例
- 短信状态码
- 中国电信错误码
- 中国联通错误码
- 中国移动错误码
- 常见问题
客户发送接口
客户发送接口
接口说明:客户接口部分提供http url方式的接口,根据客户需求可以提供相应接口,接口编码方式采用统一的UTF-8
1.1 请求地址
请求地址是客户接口程序调用时请求的url地址,采用的是http post 接口,
HTTP地址:https://www.shlianlu.com/console/loginsms.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
HTTP地址:https://www.shlianlu.com/console/loginsms.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
1.2参数说明
https://www.shlianlu.com/console/loginsms.aspx?action=send
参数名称 | 含义 | 说明 |
userid | 企业id | 企业ID |
account | 发送用户帐号 | 用户帐号,由系统管理员 |
password | 发送帐号密码 | 用户账号对应的密码 |
mobile | 全部被叫号码 | 发信发送的目的号码.多个号码之间用半角逗号隔开 |
content | 发送内容 | 短信的内容 |
sendTime | 定时发送时间 | 为空表示立即发送,定时发送格式2010-10-24 09:08:10 |
action | 发送任务命令 | 设置为固定的:send |
checkcontent | 是否检查内容包含非法关键字 | 当设置为1时表示需要检查,默认0为不检查 |
taskName | 任务名称 | 本次任务 描述100个字以内 可以为空 |
countnumber | 号码总数量 | 本次提交的号码总数量 |
mobilenumber | 手机号码数量 | 本次提交的手机号码数量 |
例如
action=send&userid=您的用户id&account=您的账号&password=您的密码
&mobile=11位手机号1,11位手机号2,11位手机号3&content=【签名】这里是短信的内容&sendTime=
&mobile=11位手机号1,11位手机号2,11位手机号3&content=【签名】这里是短信的内容&sendTime=
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>
<returnsms>
<returnstatus>status</returnstatus> ---------- 返回状态值:成功返回Success 失败返回:Faild
<message>message</message> ---------- 返回信息:见下表
<remainpoint> remainpoint</remainpoint> ---------- 返回余额
<taskID>taskID</taskID> ----------- 返回本次任务的序列ID
<successCounts>successCounts</successCounts> --成功短信数:当成功后返回提交成功短信数
</returnsms>
返回信息提示 | 说明 |
ok | 提交成功 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
发送内容包含sql注入字符 | 包含sql注入字符 |
用户名或密码错误 | 表示用户名或密码错误 |
短信号码不能为空 | 提交的被叫号码为空 |
短信内容不能为空 | 发送内容为空 |
包含非法字符 | 表示检查到不允许发送的非法字符 |
对不起,您当前要发送的量大于您当前余额 | 当支付方式为预付费是,检查到账户余额不足 |
其他错误 | 其他数据库操作方面的错误 |