订单是卖家的核心数据,卖家的很多日常工作都是围绕着订单展开,应用的基本功能就是要保证订单实时、完整的展示在卖家面前。由于API请求依赖于网络,存在 着网络不稳定和同步时间长的问题,所以应用必须把淘宝的订单数据同步到本地。
1、公共参数
请求地址: https://api-gw.onebound.cn/taobao/buyer_order_list
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
2、请求参数
请求参数:page=1&tab_code=all
参数说明:page:页码
tab_code:all,waitPay,waitSend,waitConfirm,waitRate
-标签类型(全部,待付款,待发货,待确认,待评价)
token:SaaS授权
3、响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
order_id | Bigint | 0 | 367668864711001234 | 订单ID |
shop_name | String | 0 | 充值中心 | 店铺名称 |
seller_id | Bigint | 0 | 814074396 | 卖家ID |
seller_nick | String | 0 | 君宝话费充值专营店 | 卖家昵称 |
goods | Mix | 0 | [{"goods_name": "话费充值-江西电信", "goods_id": "16262273512", "goods_image": "//img.alicdn.com/tfs/TB1c8NJSFXXXXbgXFXXXXXXXXXX-184-184.png", "unit_price": "¥10.00", "original_price": null, "goods_count": "1", "goods_info": "充值号码:199xxxxxxxx \n充值面额:10元"}] | 商品列表 |
4、代码示例
<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");
$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时,是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;
$api_data = $obapi->exec(
array(
"api_type" =>"taobao",
"api_name" =>"buyer_order_list",
"api_params"=>array (
'page' => '1',
'tab_code' => 'all',
)
)
);
var_dump($api_data);
?>