ドキュメントWorkfrontWorkfront ガイド

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