# Zeek斑馬即送簡介
Zeek 提供外賣配送服務,亦開放 Open API 給商家使用。開發者可以讓商家系統透過 Open API 調用 Zeek 的外賣配送服務,包括配送訂單管理、商店指派和獲取預計時間等操作,達致系統無縫對接。
此 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 環境提供以下資料:
資料 | 說明 |
---|---|
對接方系統的店鋪ID (client_merchant_id) | 在商家系統內的用來標記商家或店鋪的唯一ID |
商家系統 IP | Zeek 平台接口設有訪問 IP 限制,故此開發者需要提供商家系統的 IP 位址,以獲取接口訪問權限。 |
訂單狀態更新回調 URL | 用來接受訂單狀態更新的 HTTP API。請參考 API-3.9.1 訂單狀態更新回調 |
# 3. 獲得開發者帳號
開發者將會獲得開發者帳號,包括在 Sandbox 和 Release 環境的以下資料:
- App ID
- App secret
- API URL
# 4. 進行開發
開發者在 Sandbox 環境進行開發。可在API 接口說明 了解接口詳情。
# 5. Integration test
Integration test 是為系統的 API 調用進行測上。在開發完成後,在 Sandbox 環境進行測試。
# 6. Pilot test
Pilot test 是為測試配送流程。測試時,需要安排配送員及店員,模擬及測試各項配送程序。請與Zeek團隊商談營運測試安排。
# 7. 服務上線
在經過技術對接和營運測試後,可以安排配送服務上線!
配送相關 →