接口已更新并测试完毕,请旧版自动下单收货商尽快更新,任何问题欢迎询问,感谢!目录说明
一、自动下单简介、担保交易简介A、自动下单简介:
自动下单功能会大幅提高您的自动化程度,减少人工成本。原理:收货商在比价器担保交易系统发布收货需求后,系统会按最近一个月的订单取消率低于10%的价低者优先原则自动匹配库存商成交(不够的话再其余价低者优先),接着比价器报警通知他们(他)出货,若某个供应商5分钟内未查看订单我们还会自动短信通知他。
B、担保交易简介(担保交易系统已包含自动下单功能,担保交易收货商无需额外做自动下单接口):
担保交易接口会大幅提高您的自动化程度,不仅减少人工成本,还可以减少财务成本(支付宝批量付款手续费仅千分之一,每天批量付一次款即可,避免人工错误)。原理:请查看《担保交易指南》。欢迎点此免费自助开通担保交易收货帐号后认真体验一下。注:200元押金是可以随时退还的。
C、非担保交易自动下单与担保交易自动下单的区别:
担保交易系统已默认包含自动下单功能,非担保交易自动下单功能已停止使用,需自动下单功能者请用担保交易系统。
二、网关总序:(点击此处下载php代码开发包,代码同以下演示)(一) 请在比价器注册一个用户名后联系我们授权,审核后我们会告诉您用户编号(参数名为uid)和网关签名密码(参数名apikey)(二) 如何与比价器交换信息? 1、把要请求的数据和apikey一起计算出签名sign,然后再把要请求的数据和sign一起发到网关 http://api.bijiaqi.com/gateway.php 2、请求参数:必要的请求参数有以下3个
3、一次完整的发送数据到比价器的过程示范
var data = {"youdata":456,"uid":123,"cmd":"getprice"}; //这里是您需要发送到比价器的数据
注:以上开发代码请参考 cls.bijiaqi.php ,点此下载,以下示例全部使用cls.bijiaqi.php演示 var sign_data = [],request_data = []; //初始化要签名的变量和发送到比价器网关的参数变量 foreach(var name in data){ //遍历要请求的变量 if(name != "sign" && name != "apikey"){ //sign变量和apikey变量不要纳入计算 sign_data.push(name+"="+data[name]); //把要发送的数据用"参数=参数值"的字符串方式连接起来放入数组 request_data.push(name+"="+urlencode(data[name])); //要发送的数据urlencode变量之后添加到数组 } } sign_data.sort(); //参数排序:因为参数顺序不一样,md5之后的值不一样,所以需要排序 var sign = md5(apikey+sign_data.join("&")); //计算sign,sign_data排序后的数组用"&"连接起来,然后md5得到sign签名值 http.get("http://api.bijiaqi.com/gateway.php"?+request+data.join("&")+"sign="+sign); //发送数据到比价器网关 4、比价器返回结果:比价器返回的结果为utf8编码的xml文件。如下图,数据分为base节点(请求状态)和data节点(数据信息)区域。
<?xml version=”1.0” encoding=”utf-8” ?>
<root> <base><status>fail</status><errno>错误代码</errno><error>错误信息</error></base> <data>其他数据</data> </root> 三、担保交易接口-老外下单后自动发布到比价器担保交易收货,包含自动下单功能 (演示地址)1、请求参数列表
《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array( "cmd"=>"updateneed", "gameid"=>10, "serverid"=>1, "orderid"=>"No.1", "notice"=>"到这里来交易", "price"=>"0.0002", "quantity"=>1000, "minquantity"=>100, "ispublic"=>0, "isline"=>0, "isah"=>1000 //整数倍 )); 2,数据区域返回格式
<need needid="1 [需求编号]" price="0.002 [价格]" quantity="1000 [数量]" minquantity="0 [最小数量]" ispublic="1 [是否发布需求]" isline="0 [交易类型]" />
2、错误代码列表
四、担保交易订单修改1、请求参数列表
require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array( "cmd"=>"updateorder", "orderid"=>11, "remark"=>1 )); 2,数据区域返回格式
<order orderid="1 [需求编号]" price="0.002 [价格]" quantity="1000 [数量]" minquantity="0 [最小数量]" isline="0 [交易类型]"
status="订单状态" />
2、错误代码列表
五、担保交易信号返回-订单状态变更时从比价器实时发信号给您自用,您可用它自动通知顾客、财务统计等若您需实现本功能,请您联系客服预先设置好信号的接收地址(参数名为apiipn)。当订单状态变更时,比价器会使用http POST发送信号您预设的地址去,您可以使用apikey校正数据的有效性,PHP示例代码如下:
require "cls.bijiaqi.php"; //引入比价器网关类
下列为订单状态变更的变量清单:
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); if($_REQUEST['sign'] == $bijiaqi->sign($_POST)){ //orderipn为订单状态通知 if($_REQUEST['cmd'] == "orderipn"){ if($_POST['status']=='COMPLETED'){ //订单改成收货商确认收货后您的处理 echo $_POST['needorderid']; } //orderalipay为批量打款之后接收支付宝返回的信息,方便您做财务处理 }else if($_REQUEST['cmd']=="orderalipay"){ ...... } }
六、如何通过接口自动调用比价器库存数据(点此人工查看比价器库存数据表)比价器库存数据接口仅授权给自动下单收货商和部分一手担保交易收货商使用,请务必维护好您的自动下单或担保交易接口:(一) 调用全区库存数据:既可用于您参考,又可用于您汇总后发布到国外直接销售(若您自己有库存亦可将自己的库存与之汇总) 1、请求参数列表
require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array("cmd"=>"getprice")); 2、数据区域返回格式
<game> <gameid>10 [游戏ID]</gameid> <gamename>魔兽世界(美服) [游戏名称]</gamename> <gamecode>WOWUS [游戏代码]</gamecode> <argprice>0.0306 [全区扫货均价参考]</argprice> <argstockprice>0.0504 [全区库存参考均价]</argstockprice> <stock> <item serverid="1 [服务器ID]" servername="Aegwynn US – Alliance [服务器名称]" quantity="120000 [库存量]" minquantity="5000 [最小下单数量]" stockprice="0.0230 [库存参考价格]" /> </stock> ... <stock> <item serverid="1 [服务器ID]" servername="Aegwynn US – Alliance [服务器名称]" language="de [服务器语言]" price="0.0230 [扫货价格]" /> </stock> </game> 《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 3、错误代码列表
(二) 调用单区库存数据 1、请求参数列表
《比价器各服务器名称与ID对照表》请点http://www.bijiaqi.com/service/?action=hostlist下载后与贵站的服务器名称对照使用 require "cls.bijiaqi.php"; //引入比价器网关类
$bijiaqi = new bijiaqi("您的UID","您的APIKEY"); $bijiaqi->request(array("cmd"=>"showserver","serverid"=>1)); 2、数据区域返回格式 <game>
<gameid>10 [游戏ID] </gameid> <gamename>魔兽世界(美服) [游戏名称] </gamename> <gamecode>WOWUS [游戏代码]</gamecode> <avgprice>0.00295 [全区扫货均价参考]</avgprice> <avgstockprice>0.00503 [全区库存参考均价] </avgstockprice> </game> <server> <serverid>402 [服务器ID] </serverid> <servername>Tichondrius US - Horde [服务器名称] </servername> </server> <stock> <item serverid="402 [服务器id] " servername="Tichondrius US - Horde [服务器名称] " stockid="07e86b64 [库存编号] " quantity="75659 [库存数量] " minquantity="5000 [最小下单数量] " stockprice="0.00579 [库存参考价] " online="1 [用户是否登录比价器,1为在线] " failcount="65 [失败订单数] " successcount="955 [成功订单数] " orderopen="1 [用户是否对您开放下单] " ordertype="0 [下单类型,0表示只下您的即时收货订单,1表示非即时收货订单也下] " /> </stock> 3、错误代码列表
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||