深圳硕软技术有限公司 技术支持中心 24小时服务电话:0755-82682968 在线远程协助QQ:2513402938
搜索:     高级搜索

API通用接口之机主余额查询协议(TCP)

文章ID: 22
最近更新: 2016年 04月 15日
Revision: 14
添加评论
查看: 3651
评论: 0
发表: 2013年 08月 07日
通过 Ltisn L.
更新: 2016年 04月 15日
通过 Ltisn L.

一、备注说明

注:适合于代理商营业系统的技术开发人员参照使用。

本接口适用于直通车和代理商对外对接机主余额查询;

本接口限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 由提供查询放提供。

这篇文章是:  
前一个   下一个
接口文档     直通车接口之机主余额查询协议(HTTP)