API接口
流量接口,接口说明,乐信
流量接口说明
接口说明
接口地址
地址 描述
http://bcp.51welink.com:9001/WSRR.asmx WebService流量接口
http://bcp.51welink.com/api/CallApi/Index Http流量接口
Web服务CallByXML方法

常规WSDL调用方法。
传入参数:XmlInput
如C#中,添加WEB服务,并按普通类方法进行操作

Web服务JSONInput方法

以Http的请求方式, Content-Type必须设置为:application/json,以Post方式提交,并传入参数JsonInput(Json格式)

使用Jquery的Ajax代码:
var objData ={
"ServicePath":"/ZPS/WSRR/YFOW/API/QuerySeq",
"app":"aaa",
"userid":"XXX",
"t":"1446220569",
"sign":"b90f49fbdb7f9469b0d9c414d28eca58",
"seqNo":"22"    
};            
$.ajax({
    type: "POST",
    contentType: "application/json",
    url: "http://120.26.72.15:9001/WSRR.asmx/CallByJson",
    data: "{ 'JsonInput': '" + JSON.stringify(objData) + "' }",
    dataType: 'json',
    success: function (result) {
        var result = eval("["+result.d+"]");
    }
});
InputXML参数说明
参数举例
<Interface ServicePath="="/ZPS/WSRR/WebService/Platform " >
  <userid>XXX</userid> 
     <mobile> XXXXXXXXXXXX</mobile>  
</Interface>
具体说明
基本信息
名称 描述
Interface 为必须节点,固定格式
WSID 为必须节点,固定格式
APP 为必须节点,固定格式
DeviceID 必须节点可以为空,固定格式
SessionID 必须节点可以为空
User 必须节点可以为空
Pwd 必须节点可以为空,以DES加密得出
XML参数信息

Root 为必须节点,固定格式
List:为必须节点,固定格式。
Rows及以下:Rows以下的内容为列名。Rows可以出现多次,也就是多行记录,可以有多个Rows。 如果是多行记录,每一个Rows里面的列必须全部相同。列的内容请参考接口表结构。

返回结果(XML)
案例
<ROOT>
    <Result>0</Result>
    <Message>成功!</Message>
    <LIST TBName="Result">
        <Rows>
        </Rows>
    </LIST>
</ROOT>

说明:Result指示结果是否成功。0表示成功,1表示失败。如果失败,会在Message告知失败原因,本次的所有数据将不会更新,请重新调用。

JSONInput参数说明
参数举例
{
"ServicePath":"/ZPS/WSRR/WebService/Platform ",
"app":"evmandroid",
"optype":"GetData",
"tbname":"Value",
}
具体说明

整体:所有关键字全部小写
ServicePath:为必须节点,固定格式。
app:为必须节点,固定值(evmandroid)
sessionid:可以为空,固定格式
data:可以为空,固定格式。如果有值,里面为JSON数组
data对象说明:
1、 整体为JSON数组
2、 包含的每一个对象可以不一样,但是必须包含rows节点,不然会被认为无效
3、 单个对象说明:
a) optype:是指操作说明,后台会根据这个字段来进行判断所需要的操作
b) tbname:指示这个对象的名称,所有对象名称不可以重复
c) rows:数组对象,里面的内容对象可以为多个,可以理解为一个表的多行数据,但是每一行数据结构必须相同:如
"rows":[ { "VIP_ID":"112AB3EE-C1C8-41F3-B056-1C743608F251"},{ "VIP_ID":"112AB3EE-C1C8-41F3-B056-1C743608F251"}]
不允许:
"rows":[ { "VIP_ID":"112AB3EE-C1C8-41F3-B056-1C743608F251"},{ "CODE":"212AB3EE-C1C8-41F3-B056-1C743608F263"}]
4、 当data里面没有任何列或者没有数据时可以允许以下格式:
"data":[{ "total": 0, "rows": [] }]

返回结果(JSON)
{
    "result": 0,
    "message": "操作成功",
    "data": [
        {
            "rows": [
                {
                    "ID": "S0001",
                     
                    "Message": "测试1"
                },{
                    "ID": "S0002",
                 
                    "Message": "测试1"
                }
            ],
            "total": 2,
            "tbname": "Table"
        },
    ]
}
Http单号码充流量
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Range 流量类型 0 全国流量 1省内流量,不带改参数时默认为0
Account 帐号 (签名)
Mobile 号码 (签名)
Package 套餐 (签名) 流量包大小(必须在返回流量包选择内)
Sign 签名 参见签名算法
响应
TaskID 任务编码 失败为0
Code 代码
Message 消息
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=charge&account=帐号&mobile=手机号&package=100&sign=MD5
Http批量充流量
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Range 流量类型 0 全国流量 1省内流量,不带改参数时默认为0
Account 帐号 (签名)
CMPackage 移动套餐(签名) 如有移动号码则必传 传值参考getPackage返回参数
CUPackage 联通套餐(签名) 如有联通号码则必传 传值参考getPackage返回参数
CTPackage 电信套餐(签名) 如有电信号码则必传 传值参考getPackage返回参数
Mobile 号码 (签名) 半角逗号(,)分割
Sign 签名 参见签名算法
响应
TaskID 任务编码 失败为0
Code 代码
Message 消息
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=chargeBat&account=帐号&mobile=手机号逗号分割&cmPackage=100&cuPackage=100&ctPackage=100&sign=MD5
Http卡密充流量
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Account 帐号 (签名)
Mobile 号码 (签名)
CardNo 卡号(签名)
Password 卡密(签名)
Sign 签名 参见签名算法
响应
TaskID 任务编码 失败为0
Code 代码
Message 消息
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=chargeCard&account=帐号&mobile=手机号&cardNo=卡号&pssword=密码&sign=MD5
Http获取流量包定义
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Account 帐号 (签名)
Type 类型(签名) 0:不指定, 1:移动, 2:联通, 3:电信
Sign 签名 参见签名算法
响应
Code 代码
Message 消息
Packages 返回流量包
   Package 流量包
   Name 名称
   Price 价格
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=getPackage&account=帐号&sign=MD5
Http查询余额
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Account 帐号 (签名)
Sign 签名 参见签名算法
响应
Code 代码
Message 消息
Balance 余额
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=getBalance&account=帐号&sign=MD5
Http查询状态
名称 描述
Action 命令 charge
V 版本号 1.1 固定值
Account 帐号 (签名)
Count 一次取数量(签名)
Sign 签名 参见签名算法
响应
Code 代码
Message 消息
Reports 返回记录
   TaskID 任务
   Mobile 手机
   Status 4.状态成功, 5.状态失败
   ReportTime 时间
   ReportCode 代码说明
例:http://bcp.51welink.com/api/CallApi/Index?v=1.1&action=getReports&account=帐号&sign=MD5
状态被获取后服务器删除该状态 建议获取到状态后先记录一个日志
Http错误定义
错误编号 描述
001 参数错误
002 充值号码不合法
003 帐号密码错误
004 余额不足
005 不存在指定流量包
006 不支持该地区
007 卡号或者密码错误
008 该卡已使用过
009 该卡不支持(移动/电信/联通)号码
100 签名验证错误
999 其他错误
Http签名算法

按照asc排序键值对参数名排序,拼接键值对字符串(参数名小写) ,需要把api key放到要签名的键值对最后。
例如sign=MD5(aaaa=aaaa&bbbb=bbbb&cccc=cccc&dddd=dddd&key=api密钥),用32位MD5加密,生成的MD5小写

  var account = "";
  var mobile = "";
  var package = "";
  var key = "";
  //基本参数
  var action = "charge";
  var ver = "1.1";
  var host = " http://bcp.51welink.com ";
  var page = "{0}//api/CallApi/Index?action={1}&v={2}&{3}&sign={4}";
  //协议参数
  var reqParams = new Dictionary();
  reqParams.Add("account", account);
  reqParams.Add("mobile", mobile);
  reqParams.Add("package", package);
  //参数排序
  var orderedParams = reqParams.OrderBy(p => p.Key).ToDictionary(p => p.Key, p => p.Value);
  //参数拼接
  var strParam = "";
  foreach (var item in orderedParams)
    strParam += item.Key.ToLower() + "=" + item.Value.ToString() + "&";
  strParam = strParam.Trim('&');
  //构造URL
  var url = string.Format(page, host, action, ver, strParam, GetMD5(strParam + "&key=" + key));
  //请求
  var client = new WebClient();
  client.Encoding = Encoding.UTF8;
  var result = client.DownloadString(url);


  //与C#兼容的MD5加密算法
  public static string GetMD5(string s)
  {
    MD5 md5 = new MD5CryptoServiceProvider();
    byte[] t = md5.ComputeHash(Encoding.GetEncoding("utf-8").GetBytes(s));
    StringBuilder sb = new StringBuilder(32);
    for (int i = 0; i < t.Length; i++)
    {
      sb.Append(t[i].ToString("x").PadLeft(2, '0'));
    }
    return sb.ToString();
  }
产品
短信验证码
语音验证码
智能短信
国际短信
物联网解决方案
公司
关于我们
公司动态
行业动态
荣誉资质
联系我们
帮助文档
API接口
下载
帮助
隐私条款
常见问题
合作伙伴
中国联通
中国移动
中国电信
联系我们
+86 400-969-6663
7*24小时全天候服务
support@lmobile.cn

乐信平台 短信验证码平台 中山网站建设 餐饮软件 手机归属地查询 广东数据中心 北京群发短信软件 郑州做网站公司 微信分销系统 样本印刷 雨林木风 WIFI设置 济南网站制作 深圳网站建设 win10系统下载 笔记本系统 制沙机 经典语录 追溯系统 防火窗 色差仪