OAuth2 トークンを取得
最終更新日: 2024年7月17日
作成対象:
- 開発者
OAuth2 トークンの取得
認証済みユーザーの OAuth2 更新トークンとアクセストークンを返します。この呼び出しは、ユーザーがドキュメント提供者をプロビジョニングするときに 1 回だけ実行されます。その後の呼び出しは、更新されたアクセストークンを取得するために行われます。
URL
POST/any/url
この URL は設定可能で、カスタム統合設定ページのトークンエンドポイント URL 値に対応しています。
クエリパラメーター
名前 | 必須 | 説明 |
---|---|---|
grant_type | はい | 値は「authorization_code」か「refresh_token」のいずれかです。指定した値は、この API 呼び出しに渡される 2 つのパラメーターのうち、code または refresh_token のいずれかを示します。 |
コード | 依存 | ユーザーが「付与」ボタンをクリックした直後に Adobe Workfront に送信された認証コード。これは、grant_type が「authorization_code」の場合にのみ必要です。認証コードは短期間のみ有効で、通常は 10 分以内に期限が切れます。 |
refresh_token | 依存 | これは、以前の access_token が期限切れである場合に、新しい access_token を取得するために後続の呼び出しを行う場合にのみ必要です。この値を送信する場合は、grant_type パラメーターを「refresh_token」に設定します。 |
client_id | はい | このカスタム統合用に Workfront で設定されたクライアント ID。 |
client_secret | はい | このカスタム統合用に Workfront で設定されたクライアントの秘密鍵。 |
応答
名前 | タイプ | 説明 |
---|---|---|
access_token. | 文字列 | ユーザーに代わって認証済み API 呼び出しを行うために使用されるトークン。許可されていない API 呼び出しを防ぐために期限切れになります。 |
refresh_token. | 文字列 | この API メソッドを呼び出して新しい access_token を取得するのに使用される、長期間有効なトークン。 |
expires_in, | long | (オプション)access_token の有効期限が切れるまでの時間(秒単位)。通常は 3,600 です。 |
例
POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af
応答
{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43