• <track id="lietq"></track>
  • <strong id="lietq"></strong>

    <acronym id="lietq"></acronym>
    <span id="lietq"><output id="lietq"></output></span>
  • <dd id="lietq"><menu id="lietq"><b id="lietq"></b></menu></dd> <ol id="lietq"><output id="lietq"></output></ol>
  • <span id="lietq"><sup id="lietq"></sup></span>

    簡介


    為了方便網站快速接入,物流巴巴電商團隊已將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  5688.com.cn
     * Link:http://www.c6256.com/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字段所包含的數據來源信息。

    色片网站