接入文檔簡介
1.平台目的
本平台旨在規範佳吉開放平台與第三方接入平台的交互方式、交互原則、接口定義。每個接入方都有唯一的公司編碼和對應的appkey。這是雙方交互過程中唯一的識别标記。
2.交互設計原則
◆安全性
對于遠程交互,安全第一,需要避免數據在傳輸過程中被篡改,避免接口被其他方調用, 保證數據的隔離性。對接雙方需要保證各自的appkey不對外洩露。
◆穩定性
對接雙方需要保證雙方交互接口的穩定性,避免接口不穩定導緻通信過程中數據不及時,甚至數據丢失,進而對平台客戶産生影響。
◆可擴展性
物流業務會存在較多的變化,特别是對于增值服務、運輸方式、運輸範圍等,對于可能的變化,接口設計的時候需要盡量考慮後續業務發展的兼容。
◆高性能
電子商務發展很快,大業務量時,需要交互的接口性能較高,需要雙方的接口都能快速處理調用方發送的請求。
對接規範和流程
◆傳輸協議
接口通信協議采用HTTP。
◆數據交互格式
數據交互格式采用JSON。
◆編碼格式
編碼格式統一用utf-8。