注:适合于代理商营业系统的技术开发人员参照使用。
本接口适用于直通车和代理商对外对接机主余额查询;
本接口限Tcp(socket)请求;
连接端口:50815
连接地址:由服务商提供
通信方式:Socket短连接
编码方式:gb2312
报文编码:Base64
签名方式:标准MD5算法(小写字母)
提交数据包如下(Base64编码前数据):
{"Action":"CheckBalance","Body":{"AgentAccount":"admin","Phone":"15074035155"},"Sign":"b00bb39dbebff10dce056effb4b1ecaf"}
提交的数据报中字段说明:
序号 | 字段名 | 字段含义 | 字段长度 | 说明 |
1 | Action | 查询类别 | 1-20字节 | 话费固定 “CheckBalance” |
2 | Body | 业务内容 | ||
3 | Sign | 校验码 | 32字节 | MD5值,小写 |
Body 字段说明
序号 | 字段名 | 字段含义 | 字段长度 | 说明 |
1 | AgentAccount | 账户名称 | 1-20字节 | 账户名称,找供应商提供 |
2 | Phone | 手机号 | 11 位 |
测试帐户: AgentAccount =admin
测试密码: BalanceKey=fa49b620
手机号码:Phone=15074035155
Sign=Md5(base64('{"AgentAccount":"Admin","Phone":"15074035155"}')+BalanceKey);
对以下字串做Base64编码后发送socket:
{"Action":"CheckBalance","Body":{"AgentAccount":"admin","Phone":"15074035155"},"Sign":"b00bb39dbebff10dce056effb4b1ecaf"}
服务端返回数据(对字串做Base64反编码后得到的数据):
返回格式:
RecBody:={"Action":"CheckBalance","Body":{"Phone":"15074035155","Name":"张三","Balance":93.4,"Package":"49动感地带套餐","Brand":"动感地带","IsSuccess":1,"ErrorMsg":""},"Sign":""};
注明:BalanceKey 由提供查询放提供。