為了方便網(wǎng)站快速接入，物流巴巴電商團(tuán)隊(duì)已將HTTP通訊請求(基于 Request Payload )封裝成獨(dú)立的SDK文件，您僅需引入SDK文件，并構(gòu)造簡單的請求參數(shù)，即可得到服務(wù)器返回的標(biāo)準(zhǔn) JavaScript 對象標(biāo)記 (JSON) 數(shù)據(jù)，而無需具備基本的HTTP協(xié)議知識背景，方便、簡單。
用戶通過指定API參數(shù)來獲取對應(yīng)的結(jié)果，物流巴巴海運(yùn)費(fèi)查詢的API參數(shù)集如下表所示：
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| key | string | 必填 | 用戶統(tǒng)一授權(quán)KEY，需在實(shí)例化sdk后，為對象指定key屬性 |
| type | string | 必填 | 請求海運(yùn)數(shù)據(jù)的類型：fcl整箱,lcl拼箱 |
| pol | string | 必填 | 起運(yùn)港口簡碼 |
| pod | string | 必填 | 目的港口簡碼 |
| per_page | int | 必填 | 每個(gè)頁面中希望展示的數(shù)量 |
| current_page | int | 必填 | 當(dāng)前數(shù)據(jù)分頁 |
下載SDK，并引入到您的項(xiàng)目文件中，示例代碼：
?<?php
/**
* API接口演示程序
* Auth: 物流巴巴
* Date: 2016/5/20
* Copyright 5688.com.cn
* Link:http://m.ttm3.cn/ports 港口簡碼查詢
*/
require_once "class.awice.php";
$_api_key='你的KEY';
$api = new Awice();
$api->key = $_api_key;
$_result = $api->payLoad(
array(
'type' => 'fcl',
'pol' => 'CNSZN',
'pod' => 'AUSYD',
'per_page' => 10,
'current_page' => 1
)
);
//顯示結(jié)果
header('Content-type: application/json');
echo $_result;
請求發(fā)送后，服務(wù)器將返回標(biāo)準(zhǔn)JSON字符串：
請注意，所有的響應(yīng)都包含在JSON對象result根元素中，響應(yīng)對象中的 "status" 字段包含了請求的狀態(tài)，未出現(xiàn) 任何錯誤時(shí)status的值為1，當(dāng)status值為1之外的值時(shí)，響應(yīng)對象中可能會包含一個(gè)附加的 err_msg 字段，此字段詳細(xì)地說明了給定狀態(tài)代碼背后的原因。
響應(yīng)字段說明，列表如下：
| 節(jié)點(diǎn) | 字段(屬性) | 說明 |
|---|---|---|
| / | status | 請求狀態(tài) 1：成功 0:失敗 |
| / | err_msg | status字段為1以外的值時(shí)，返回包含的錯誤信息。 |
| /metaData | polCode、podCode、perPage、pageNow、pageCount、link | 起運(yùn)港簡碼、目的港簡碼、每頁顯示的數(shù)據(jù)數(shù)量、當(dāng)前第幾頁、總頁數(shù)、數(shù)據(jù)來源 |
| /recordSet | cls、etd、tt、stdate、enddate、oceanFreight[]、localCharges[] | 截關(guān)日，開船日，有效期（始），有效期（止），海運(yùn)費(fèi)(數(shù)組)，附加費(fèi)(數(shù)組) |
為保障系統(tǒng)穩(wěn)定，服務(wù)器原子性（atomicity）數(shù)據(jù)統(tǒng)計(jì)機(jī)制會精確統(tǒng)計(jì)用戶每一次請求行為，超出請求頻率后系統(tǒng)會自動鎖定用戶請求60（S）,超出請求上限后，系統(tǒng)將返回錯誤信息。
單位時(shí)間（天）內(nèi)，用戶請求上限：1000次；
單位時(shí)間（分）內(nèi)，最大用戶并發(fā)請求30次；
*此值可能會隨著用戶的實(shí)際需求適時(shí)做出相應(yīng)調(diào)整，以保障用戶的最大需求。
用戶使用此接口時(shí)，應(yīng)在醒目位置顯示JSON對象中l(wèi)ink字段所包含的數(shù)據(jù)來源信息。