Http 接口调用帮助说明
 

HTTP接口支持在IE浏览器上直接测试调用接口。

为增加帐户安全性,系统默认是不绑定访问IP,建议您测试接入正常部署在服务器后,让我们客服把您们帐户绑定您们调用的服务器 访问IP。

注意:批量充值可以一次提交100-500个充值号码,支持Http的Get或者Post调用 。



一、GetBalanceStr(int Id, string Name, string Psw) 接口调用

接口说明:获取帐号流币余额相关信息。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码 支持使用明文或MD5加密大写

返回值:int 数字型  
返回值 说明 备注
大于或等于0 返回帐户流币余额 返回值>=0 调用接口成功返回帐户余额
空值 调用接口失败  
-1 帐户处于禁止使用状态  
-2 帐户信息错误 调用的参数有为空值
-3 用户或密码错误 机构代码、用户名或密码错误
-4 不是普通帐户 该帐户不能使用Web Service 接口模式(如:代理帐户或集团帐户等)
注:只有普通用户才能使用Web Service 接口
-30 非绑定访问IP 访问访问IP非法

例如Http Get 调用方式:http://访问IP:7180/service.asmx/GetBalanceStr?Id=机构代码&Name=帐户名&Psw=密码

 访问IP 请替换实际接口访问访问IP地址或者域名



 
二、UpdatePswStr 接口调用

接口说明:更改帐号密码。
参数 类型 说明 备注
Id int 机构代码
Name string 帐户名
OldPsw string 旧密码  
NewPsw string 新密码

返回值:int 数字型  
返回值 说明 备注
1 修改密码成功
-1 修改密码失败
其他值 参考GetBalance()返回值说明

例如Http Get 调用方式:http://访问IP:7180/service.asmx/UpdatePswStr?Id=机构代码&Name=帐户名&OldPsw=旧密码&NewPsw=新密码




三、GetLlbStr(int Id, string Name, string Psw,int pType) 调用

接口说明:获取3大运营商流量包套餐信息。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码  
pType int 运营商类型,pType值0移动,1联通,3电信 获取指定运营商流量包信息,该值只能是0,1,3

返回值:String 字符型  
返回值 说明 备注
超过5字符 返回指定运营商的流量包信息
返回格式如:5M|5|5;10M|10|9;50M|50|45;100M|100|90

每个流量包用半角分号“;”分隔,流量包内用“|”分隔。

各项顺序意思是:流量包套餐名称|流量大小值(单位M)|计费流币

在充值接口需用到数据项:流量包套餐名称
空值 调用接口失败  
-1 帐户处于禁止使用状态  
-2 帐户信息错误 调用的参数有为空值
-3 用户或密码错误 机构代码、用户名或密码错误
-4 不是普通帐户 该帐户不能使用Web Service 接口模式(如:代理帐户或集团帐户等)
注:只有普通用户才能使用Web Service 接口
-5 错误pType类型参数值  
-30 非绑定访问IP 访问访问IP非法


例如Http Get 调用方式:http://访问IP:7180/service.asmx/GetLlbStr?Id=机构代码&Name=帐户名&Psw=密码&pType=0





四、LlbCzStr(int Id, string Name, string Psw,string Phone,string YD,string DX,string LT) 调用

接口说明:接收流量充值数据。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码 支持使用明文或MD5加密大写
Phone string 流量充值号码,多个号码用半角分号“;"分隔
每次调用接口传递号码数量不能超过1000个(建议100个/次调用)。
YD string
移动号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含移动号码,该值可以是长度为0的空字符串,否则不能为空

流量包套餐名称可在GetLlb()接口pType=0获取
DX string
电信号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含电信号码,该值可以是长度为0的空字符串,否则不能为空
流量包套餐名称可在GetLlb()接口pType=3获取
LT string
联通号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含联通号码,该值可以是长度为0的空字符串,否则不能为空

流量包套餐名称可在GetLlb()接口pType=1获取

返回值:String 字符型  
属性 类型 返回值 说明 备注
FailPhone string 失败号码 返回流量充值失败的号码  多个失败号码之间以半角分号“;"分隔
Id int 批号 返回服务器保存流量充值的批号ID  
State int  1 提交流量充值成功  
-1 提交失败  
-6 流量包名称参数错误  YD,DX,LT流量包套餐名称不能全为空
-7 流量充值的号码为空  
-8 帐户流币余额不足  
-9 接收数据失败  
-10 流量充值失败  号码错误
-13 移动流量包套餐参数错误  
-14 电信流量包套餐参数错误  
-15 联通流量包套餐参数错误  
-16 黑名单号码
其他值 参考GetLlb()返回值说明  


例如Http Get 调用方式:http://访问IP:7180/service.asmx/LlbCzStr?Id=机构代码&Name=帐户名&Psw=密码&Phone=充值号码&YD=移动流量包套餐名称&DX=电信流量包套餐名称&LT=联通流量包套餐名称


例子:机构代码:300,帐户名称:fjs 帐户密码:123456,对移动和联通手机充值100M流量套餐 使用Get方式调用接口如下

http://访问IP:7180/service.asmx/LlbCzStr?Id=300&Name=fjs&Psw=123456&Phone=13724005383;13025152222&YD=100M&DX=&LT=100M

http://访问IP:7180/service.asmx/LlbCzStr?Id=300&Name=fjs&Psw=123456&Phone=13724005383&YD=100M&DX=&LT=
http://访问IP:7180/service.asmx/LlbCzStr?Id=300&Name=fjs&Psw=123456&Phone=13025152222&YD=&DX=&LT=100M

例子中访问IP 请替换实际接口访问访问IP地址或者访问域名




五、LlbCzTimerStr(int Id, string Name, string Psw,string Phone,String CzTime,string YD,string DX,string LT) 调用

接口说明:接收定时流量充值数据。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码 支持使用明文或MD5加密大写
Phone string 接收号码,多个号码用半角分号“;"分隔 每次号码数量不能超过1000个
CzTime String 定时流量充值的时间
(格式:2016-03-08 10:20:00)
定时时间必须大于当前调用时间。
YD string
移动号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含移动号码,该值可以是长度为0的空字符串,否则不能为空

流量包套餐名称可在GetLlb()接口pType=0获取
DX string
电信号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含电信号码,该值可以是长度为0的空字符串,否则不能为空
流量包套餐名称可在GetLlb()接口pType=3获取
LT string
联通号码需要充值流量包套餐的名称。

如传递Phone充值号码没有包含联通号码,该值可以是长度为0的空字符串,否则不能为空

流量包套餐名称可在GetLlb()接口pType=1获取

返回值:String 字符型  
属性 类型 返回值 说明 备注
FailPhone string 失败号码 返回流量充值失败的号码 多个失败号码之间以半角分号“;"分隔
Id int 批号 返回服务器保存流量充值的批号ID  
State int  1 提交定时流量充值成功  
-1 定时失败  
-6 流量包名称参数错误  YD,DX,LT流量包套餐名称不能全为空
-7 流量充值的号码为空  
-8 余额不足  
-9 接收数据失败  
-10 定时流量充值失败 号码错误
-11 定时流量充值时间或格式错误 (格式:2010-03-08 10:20:00)
-12 定时流量充值时间失败 定时时间必须大于当前调用时间。
-13 移动流量包套餐参数错误  
-14 电信流量包套餐参数错误  
-15 联通流量包套餐参数错误  
  其他值 参考GetLlb()返回值说明  

例如Http Get 调用方式:http://访问IP:7180/service.asmx/LlbCzTimerStr?Id=机构代码&Name=帐户名&Psw=密码&Phone=充值号码&CzTime=定时时间&YD=移动流量包套餐名称&DX=电信流量包套餐名称&LT=联通流量包套餐名称


六、OneLlbCzStr(int Id, string Name, string Psw,string Phone,string LLB) 调用

接口说明:接收单个号码流量充值数据。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码 支持使用明文或MD5加密大写
Phone string 单个手机号码流量充值,不能多个号码
LLB string
流量包套餐名称,如单个号码是移动号码必须要对应移动流量包套餐,联通号码必须要对应联通流量包套餐,电信号码必须要对应电信流量包套餐
流量包套餐名称可在GetLlb()接口获取

返回值:String 字符型  请参考LlbCzStr()返回值



例如Http Get 调用方式:http://访问IP:7180/service.asmx/OneLlbCzStr?Id=机构代码&Name=帐户名&Psw=密码&Phone=充值号码&LLB=流量包套餐名称



例子:机构代码:300,帐户名称:fjs 帐户密码:123456,对移动手机充值100M流量套餐 使用Get方式调用接口如下 

http://访问IP:7180/service.asmx/OneLlbCzStr?Id=300&Name=fjs&Psw=123456&Phone=13724005383&LLB=100M

例子中访问IP 请替换实际接口访问访问IP地址或者访问域名