“智慧生活宝话费接口(HTTP版)V1.0 是一个用于全国话费充值的API,支持移动、联通、电信三大运营商。该接口由周金龙在不同时间进行开发和更新,包括添加错误代码、商户金额查询和话费余额查询等功能。”
在这个接口中,有两个主要的接口操作:
1. **缴费提交接口**:用于进行实际的话费充值操作。接口地址是 `http://host/phone.aspx?type=orderphone`。这个接口需要以下参数:
- `uid`:用户编号,必填,数字形式。
- `phone`:缴费号码,必填,手机号码为11位,固话和小灵通号码前需加0。
- `price`:缴费金额,必填,范围在10-500元之间,可能根据不同的商务协议有所调整。
- `orderid`:用户订单号,必填,10-50位,包含数字、字母和下划线,且不能重复。
- `ordertype`:订单类型,必填,1代表手机充值,2代表固话充值。
- `sign`:密钥,必填,基于MD5算法生成的签名,包括`Uid+phone+price+orderid+ordertype+key`。
其中,`sign`的生成是安全性的关键,确保了请求的完整性和防止篡改。提交成功后,服务器会返回一个JSON对象,包含`Code`和`Info`字段,例如:`{Code:’0000’,Info:’提交成功’}`,`Code`为'0000'表示操作成功。
2. **缴费状态查询接口**:用于查询充值订单的状态。接口地址是 `http://host/phone.aspx?type=querystate`。同样需要以下参数:
- `uid`:用户编号,必填。
- `orderid`:用户订单号,必填。
- `ordertype`:订单类型,必填。
- `sign`:签名,必填,基于MD5算法生成,包括`uid+orderid+ordertype+key`。
这个接口返回一个3位数字编码,对应错误列表中的状态码,用于判断充值操作的状态。
这个接口的稳定性和良好的功能扩展性,使得它适用于各种需要在线话费充值的场景,比如电商平台、应用内支付等。通过调用这两个接口,开发者可以轻松地集成全国范围内的手机和固话充值服务,提供给用户方便快捷的充值体验。同时,接口的错误处理机制(如错误代码1005的描述)也确保了在出现问题时能够及时反馈和解决。