メインコンテンツへスキップ
Box Postmanコレクションでは、アクセストークンを使用してユーザーの代わりにAPIリクエストを認証します。アクセストークンは1時間後に期限切れになるため、更新する必要があります。

更新トークンの使用

PostmanクイックスタートのBoxアプリを構成した場合、Box環境には有効なclient_idclient_secretを用意する必要があります。これらをrefresh_tokenと併せて使用することで、新しいaccess_tokenを取得できます。
Postman環境で有効なクライアントIDとクライアントシークレット
アクセストークンを更新するには、Box Postmanコレクションで [Authorization (承認)] フォルダを開き、[Refresh access token (アクセストークンを更新)] を選択します。
PostmanのRefresh access token APIコール
[Send (送信)] をクリックします。
Postmanの [Send] ボタン
成功した場合は、新しいaccess_tokenrefresh_tokenで環境が更新されるため、APIコールの実行を再開できます。
更新トークンは1回のみ使用可能で、使用せずに60日が経過すると有効期限が切れます。更新トークンは使用するたびに新しいものが発行され、60日の期限もリセットされます。更新トークンの有効期限が切れると、再度を実行して新しいトークンペアを取得する必要があります。

トークンの自動更新

Box Postmanコレクションはリクエストを送信する前に、有効期限が切れたaccess_tokenを自動的に検出して更新することができます。この機能はデフォルトで有効になっています。 これを切り替えるには、Box Postman環境を編集し、enable_auto_refresh_access_token変数をtrueまたはfalseに設定します。
Box Postmanの環境変数
自動更新を有効にすると、コレクションは各APIコールの実行前にaccess_tokenの有効期限が切れているかどうかをチェックし、必要に応じてトークンを自動的に更新します。

再認証

refresh_tokenの有効期限が切れた場合、通常は60日以上コレクションが使用されていないため、をもう一度行って再認証する必要があります。 やり直す前に、既存のBox Postman環境を削除します。右上にある歯車アイコンをクリックし、環境を選択して [Delete (削除)] をクリックします。
Box Postman環境の削除
次に、を最初から実行します。
Box Postmanコレクションを再インポートする際に、コピーとしてインポートするか、既存のものを置き換えるかをPostmanから問われる場合があります。コピーとしてインポートすると、APIリクエストに対して行った独自の変更は保持されます。