"中国短信网提供了HTTP接口,允许开发者通过HTTP GET或POST方式与服务器交互,实现短信服务的使用。接口文档版本为v2.2,接口域名为api.c123.com。"
该文档详细介绍了如何利用HTTP接口进行短信服务操作,包括发送短信、接收回复、查询剩余短信条数等核心功能。以下是对各部分的详细解释:
1. **工作方式**
- 通信方式:使用HTTP的GET和POST方法传递数据,以"name=value"的形式提交内容。
- 安全验证:基于用户名和密码的验证机制,确保数据传输的安全性。
- 响应机制:每次请求都会得到一个纯文本格式的响应,包含状态码。
2. **字符编码**
- 接收编码:服务器支持GBK和UTF-8两种编码,默认接收GBK编码,若提交UTF-8编码需指定`encode=utf8`参数。
- 响应编码:响应内容始终以GBK编码返回。
3. **响应格式**
- 响应内容:每次请求后的返回值,以纯文本形式表示。
- 状态码:例如,发送成功后返回的状态码为100。
4. **短信发送**
- 操作格式:通过GET或POST方法,以URL或请求体的形式提交数据。
- 参数说明:
- `uid`:用户账号。
- `pwd`:32位小写MD5加密的用户密码。
- `time`:定时发送的时间,如"2010-05-27 12:01",可选。
- `mid`:子扩展号,可选,取决于用户账号是否支持。
- `encode`:字符编码,可选,默认GBK,提交UTF-8需指定。
- `mobile`:接收号码,多个号码用英文逗号分隔,GET最大50个,POST最大2000个。
- `content`:短信内容,需URL编码。
5. **接收回复短信**
- 文档未明确说明具体接收回复短信的操作,通常可能需要监听服务器提供的特定端点以接收回复。
6. **取剩余短信条数**
- 同样,具体操作未在概述中明确,一般会有特定的API接口用于获取剩余短信数量。
7. **程序示例**
- 提供了程序示例帮助开发者理解如何实际调用接口,但具体内容未在摘要中给出。
8. **下载资源**
- 最新文档和接口程序的下载地址分别提供,方便开发者获取详细信息和开发工具。
综上,中国短信网的HTTP接口适用于需要集成短信服务的应用或系统,开发者可以通过遵循提供的接口规范,轻松实现短信的发送、接收等功能。为了安全和效率,建议使用POST方法发送大量号码,并注意字符编码的正确设置。