メインコンテンツまでスキップ

アプリ (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 ヘッダーにキーを渡して認証します。
  • トグルスイッチで有効化/無効化できます。