應用程式 (App)

您可以在 Gency API 中心建立並管理專屬於自己的應用程式。

基本資訊

建立應用程式後，即可設定以下資訊。

• 應用程式圖示與名稱：此圖示與名稱會在以下情境中顯示：
  • OAuth 授權同意畫面
  • Bot 使用者個人檔案 (Bot: {앱 이름})
• 說明（最多 500 字）：說明應用程式的用途與功能。

認證資訊

建立應用程式時會自動發行以下認證資訊。

• Client ID：以 gency_client_{랜덤문자열} 格式發行。用於在 OAuth 流程中識別應用程式。
• Client Secret：以 gency_secret_{랜덤문자열} 格式發行。點擊 Secret 重新發行 按鈕後會發行新的密鑰，既有密鑰會立即失效。
• Redirect URIs：OAuth 授權流程中使用的重新導向 URL 清單。授權請求時傳遞的 redirect_uri 必須與此處註冊的其中一個 URI 相符。

範圍

以核取方塊選擇應用程式要使用的 OAuth 範圍。授權請求時只能傳遞此處註冊的範圍。

範圍	說明
product:read	商品清單查詢
product:write	商品建立/修改/刪除
team:read	團隊查詢
team:write	團隊修改/管理
user:read	使用者查詢

API Key

可代替 OAuth 權杖，簡便地呼叫 API 的金鑰。

• 啟用 API Key 後即可使用 API Key。
• 啟用時會自動建立 Bot 使用者並註冊為團隊成員。
• 呼叫 API 時，在 X-API-Key 標頭中傳遞金鑰以進行認證。
• 可透過切換開關啟用/停用。

---