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