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