# Zeek斑馬快送簡介
Zeek斑馬快送 (ZeekDash)是 Zeek 提供的生活類點到點配送服務,同時亦開放 Open API 給商家使用。透過 Open API,開發者可以讓商家系統調用快送服務,進行創建訂單、查詢訂單等操作,達致系統無縫對接。
此 Open API 僅供月結商家使用,詳情請與 Zeek 銷售部同事聯絡。
# 詞彙
在本文檔內,會用上一些通用詞彙,以下是它們的說明。
名詞 | 意義 |
---|---|
Zeek 平台 | Zeek 配送平台,提供各類的配送服務,包括外賣配送、斑馬快送等。 |
商家 | 使用 Zeek 配送服務的商家,一般來說商家代表店鋪。 |
對接方系統 | 將會調用 Open API 接口的系統,一般指商家的系統。 |
開發者 | 代表商家與 Zeek 平台進行技術對接的人員。 |
配送員 | Zeek 平台上的配送員,負責執行平台上的配送工作。 |
配送訂單 | 使用服務時在 Zeek 平台上生成的訂單,訂單上記錄了服務需求及用來追蹤配送狀態。 |
# 對接環境
開發者可以使用以下 Zeek Open API 環境對接:
# Sandbox 環境
開發者可以在 Sandbox 環境進行 API 對接及測試。我們提供額外開發環境給定製化對接的客戶,請與我們團隊聯絡。
# Release 環境
Release 環境是正式運作的環境。
# 如何接入
在使用 Open API 接入快送配送服務時,一般需要經過以下的步驟:
# 1. 合作前期溝通
商家和 Zeek 團隊商談合作事宜,包括服務使用模式、計費等等。
# 2. 提供商家資料
開發者需要開發者帳號才能使用 Open API。在開設帳號之前,商家需要為 Sandbox 和 Release 環境提供以下資料:
資料 | 說明 |
---|---|
商家系統 IP | Zeek 平台接口設有訪問 IP 限制,故此開發者需要提供商家系統的 IP 位址,以獲取接口訪問權限。 |
訂單狀態更新回調 URL | 用來接受訂單狀態更新的 HTTP API。請參考 PA-API-3.4 訂單狀態回調 |
# 3. 獲得開發者帳號
開發者將會獲得開發者帳號,包括在 Sandbox 和 Release 環境的以下資料:
- App ID
- App secret
- API URL
# 4. 進行開發
開發者在 Sandbox 環境進行開發。可在API 接口說明 了解接口詳情。
# 5. 技術對接測試
在開發完成後,在 Sandbox 環境進行技術對接測試。
# 6. 營運測試
請與Zeek團隊商談營運測試安排
# 7. 服務上線
在經過技術對接和營運測試後,可以安排配送服務上線!
配送相關 →