接入文檔簡介

1.平臺目的

本平臺旨在規范佳吉開放平臺與第三方接入平臺的交互方式、交互原則、接口定義。每個接入方都有唯一的公司編碼和對應的appkey。這是雙方交互過程中唯一的識別標記。

2.交互設計原則

◆安全性

對于遠程交互，安全第一，需要避免數據在傳輸過程中被篡改，避免接口被其他方調用， 保證數據的隔離性。對接雙方需要保證各自的appkey不對外泄露。

◆穩定性

對接雙方需要保證雙方交互接口的穩定性，避免接口不穩定導致通信過程中數據不及時，甚至數據丟失，進而對平臺客戶產生影響。

◆可擴展性

物流業務會存在較多的變化，特別是對于增值服務、運輸方式、運輸范圍等，對于可能的變化，接口設計的時候需要盡量考慮后續業務發展的兼容。

◆高性能

電子商務發展很快，大業務量時，需要交互的接口性能較高，需要雙方的接口都能快速處理調用方發送的請求。

對接規范和流程

◆傳輸協議

接口通信協議采用HTTP。

◆數據交互格式

數據交互格式采用JSON。

◆編碼格式

編碼格式統一用UTF-8。