Skip to main content
手上有了存取權杖，你就可以開始呼叫 API 了。每一次呼叫都會送到同一個 GraphQL 端點——由權杖決定你正在操作的是哪個帳戶。

​
端點

沒有版本化的 REST 路徑，也沒有依功能區分的基礎 URL。你會將每一個查詢與變更操作都送到同一個位址。

​
確認你的權杖可以運作

getMerchants 是以最低成本端到端驗證你整個設定的方式。它不會讀取任何敏感資料、不會搬移資金，且只需要 LIST_OFFERS 這一個權限範圍。
運作正常的權杖會回傳該商家：
光是這一個回應，就同時確認了四件事：你的端點正確、你的權杖有效、它攜帶了這個查詢所需的權限範圍，而且它的範圍屬於一個可以讀取商家目錄的帳戶。
空陣列不代表錯誤。 getMerchants 會依名稱篩選，因此測試環境目錄中不存在的商家會回傳 []，且不帶 errors 區塊。如果得到空結果，可以試著不帶 name 參數執行查詢，看看測試環境目前有哪些商家。

​
當它無法運作時

權杖在查詢執行前就被拒絕。最常見的原因是憑證來自錯誤的環境——測試環境與正式環境使用各自獨立的應用程式。請參閱如果權杖請求回傳 401。
權杖有效，但缺少此操作所需的權限範圍。錯誤訊息會指名是哪一個，例如 getMerchants requires LIST_OFFERS。請鑄造一個加上該權限範圍的新權杖——權限範圍在鑄造當下就固定了，事後無法擴大。
查詢與 schema 不符——通常是欄位不存在，或引數格式錯誤。回應內容會指名是哪個欄位出了問題。請在API 參考文件中檢查該操作。當查詢超出查詢成本限制時，也會回傳相同的代碼，並搭配 HTTP 400。此時訊息會顯示 Query Cost limit of 7000 exceeded；請減少選取的欄位，或將查詢拆成較小的查詢。

​
下一步去哪裡

你的第一筆禮品卡購買

存入資金、購買禮品卡，並揭露其兌換細節——完整的 happy path。

建立虛擬卡並開始消費

選擇卡片方案、發行具備消費控管的卡片，並追蹤其活動。

冪等性

搬移資金的變更操作都需要 idempotencyKey。第一次寫入前，請先閱讀本文。

API 參考

每一個查詢、變更操作與型別。