# Zeek班馬快送簡介

Zeek班馬快送 (ZeekDash)是 Zeek 提供的生活類點到點配送服務,同時亦開放 Open API 給商家使用。透過 Open API,開發者可以讓商家系統調用快送服務,進行創建訂單、查詢訂單等操作,達致系統無縫對接。

# 詞彙

在本文檔內,會用上一些通用詞彙,以下是它們的說明。

名詞 意義
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. 服務上線

在經過技術對接和營運測試後,可以安排配送服務上線!