Skip to main content

取得你的 API 憑證

在 Developer Console 建立應用程式後,選取該應用程式即可找到其 API KeyUser IDAccount ID
在哪裡找到: Developers page,進入你建立的應用程式內。這些憑證用於 API key 授權 —— 主要用於管理性呼叫與產生使用者存取權杖。
Obtain API credentials 每個 Fluz API 請求都會在 Authorization 標頭中使用使用者存取權杖(user access token)。你可以以 Authorization: Basic <API_KEY> 標頭呼叫 generateUserAccessToken mutation 來鑄造該權杖,並將主控台中的 User IDAccount ID 作為參數傳入。

產生存取權杖

回應會包含存取權杖以及其所攜帶的 scopes:

使用該權杖

將權杖附加到對 transactional graph 的每個 GraphQL 請求:
絕對不要將你的 API key 交付到瀏覽器或行動端客戶端。請在伺服器端鑄造存取權杖,若有必要,再僅將該權杖轉發給客戶端。

在到期前鑄造新權杖

存取權杖為短期有效。請在目前權杖到期前鑄造新的——不要等到收到 401。請參閱 Replace an Expired Access Token 取得精確的呼叫方式,並參閱 Authentication 了解完整流程,其中包含客戶範疇權杖的 OAuth 授權。

後續步驟

快速入門:你的第一張禮品卡購買

端到端跑完完整 happy path——存入資金、購買禮品卡,並在沙盒中揭示它。

替換已到期的權杖

當目前的權杖到期時,鑄造新的存取權杖。