簡介


浙江舟山飞鱼开奖号码 www.uvlgf.tw 為了方便網站快速接入,物流巴巴電商團隊已將HTTP通訊請求(基于 Request Payload )封裝成獨立的SDK文件,您僅需引入SDK文件,并構造簡單的請求參數,即可得到服務器返回的標準 JavaScript 對象標記 (JSON) 數據,而無需具備基本的HTTP協議知識背景,方便、簡單。

API參數集


用戶通過指定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  www.uvlgf.tw
 * Link://www.uvlgf.tw/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字段所包含的數據來源信息。