May 7, 2024

入門指南：利用 Shopify Draft Order API 創建和管理草稿訂單

Draft Order API 簡介

Draft Order 草稿訂單是店主在客戶想要購買產品但尚未付款時可以創建的訂單的初步版本，這是店主為客戶創建的訂單，而不是他們自己創建的訂單！所以草稿訂單本質上是初步發票，允許商家在最終確定之前概述客戶訂單的詳細資訊，在處理通過傳統在線店面以外的其他管道下達的訂單時，例如電話訂單、電子郵件請求或親自參加活動或市場，這非常有用。

在當今的網路購物時代，電子商務平台越來越受到大眾的喜愛，而訂單管理系統則是這些平台必不可少的核心功能之一。为了提供店家更簡便、靈活的訂單管理方式，許多平台紛紛開發出了稱為 Draft Order API 的功能。

Draft Order API 是一種應用程式接口（API），透過此 API，開發者能於訂單管理系統中創建、編輯、管理被稱為「草稿訂單」的初階訂單，與此同時，開發者透過程式化的操作方式，不僅提升了訂單處理的效率，更增添了管理訂單的靈活度。

草稿訂單 (Draft Order)，指的是當消費者決定要購買特定商品，但尚未完成付款動作時，店家可以先行建立的訂單的初步版本，這不是由消費者自己建立的訂單，而是由店家為消費者建的，草稿訂單基本上可以視為是一份初步的發票，他讓商家可以在最終確認訂單前，先對客戶訂單的細節做一次總結。

接著進入我們今次的使用情境。今天我們想做一個抽獎，當店家希望從客戶那裡獲取更多的資料時，可能會要求客戶進一步留下資料，一旦這些資料被提交，我們的系統將自動將這些資訊轉化為一個草稿訂單，然後轉入後台儲存，之後，店家能夠在後台進行人工篩選，選定哪些客戶將會收到 Shopify 的發票，繼續藉由 Draft Order API，店家能靈活、效率地修改訂單資訊、進行訂單管理。

開發環境設置

要開始使用Draft Order API，開發者需要設置相應的開發環境。這包括註冊和獲取API金鑰，配置開發工具，以及確保網絡連接穩定。通常，開發者可以通過官方文檔或開發者社區獲取相關的資源和指南。

現在如何拿到金鑰，就照著圖片的只是一步步操作，如果有任何問題也可以隨時看官方文檔（Create an app）！

1. 創建一個開發者app，並給予app名字

2. 開啟app想要使用的權限，現在我們開始draft order的權限

3. 安裝app

現在每個步驟都完成了，你會有這幾個重要的資訊API access token , API key,API secret key 。

發送和處理 API 請求

一旦開發環境設置完成，開發者就可以開始發送API請求。這些請求包括創建、編輯、查詢和刪除草稿訂單等操作。開發者需要熟悉API端點和請求格式，現在我們就來發送第一個新增Draft Order的吧！

準備 Postman，使用以下 URL 創建一個新的 POST 請求：

https://{API_key}:{admin_API_access_token}@{shop}.myshopify.com/admin/api/{api-version}/{resource}.json


{API_key} - 您生成的 API 金鑰。
{admin_API_access_token} - 您生成的管理員 API 訪問令牌。
{shop} - 您的開發商店的名稱。
{api-version} - 您想要使用的支持的 API 版本。
{resource} - 來自 REST 管理 API 的資源端點。

在 Postman 中要傳輸的body，可以在主體部分(body)，點擊原始(raw) → 選擇 JSON，然後輸入代碼。

以下是一個最基本的 body 範例，可以依據需求增添想要創建的 Draft Order 內容。

{
    "draft_order": {
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }]
    }
}

以下為另一個比較複雜的案例：

{
    "draft_order": {
        "email":"zxcdd@gmail.com",
        "line_items": [{
            "variant_id": 44901956681980,
            "quantity": 1
        }], 
        "shipping_address":{
            "first_name":"Bob",
            "last_name":"Norman",
            "address1":"123 Main St",
            "phone":"555-555-5555"},
       "note_attributes": [
            {
                "name": "discord id",
                "value": "zx7"
            }
        ],
        "tags":"zxcdd@gmail.com"
    }
}