<kbd id='codyl'></kbd><address id='ipljc'><style id='ypayd'></style></address><button id='jifhv'></button>

          簡介


          為了方便網站快速接入,平安彩票官方网站電商團隊已將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.5688.com.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字段所包含的數據來源信息。