アクセストークンを安全に更新する

ShareAI OAuthリフレッシュトークンをバックエンドで回転させ、置き換えを原子的に保存し、有効期限切れや再生をリトライループなしで処理してください。

このページについて

アクセストークンが期限切れになり、顧客の付与がまだ有効な場合はリフレッシュトークンを使用してください。リフレッシュは同意画面を表示しません。元のアカウントと認可境界を保持します。

POST https://auth.shareai.now/oauth/token

新しいアクセストークンを発行し、リフレッシュトークンを回転させます。

ベースURL: https://auth.shareai.now
認証: 機密クライアント認証

cURL

curl --fail-with-body "https://auth.shareai.now/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=refresh_token" \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "client_secret=$SHAREAI_CLIENT_SECRET" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"

両方の置き換えを一緒に保存してください。#

同じ顧客認可に対するリフレッシュ操作を直列化します。1つのアプリケーションリクエストがリフレッシュを実行し、他のリクエストは待機する必要があります。
設定されたクライアント認証方法を使用して現在のリフレッシュトークンを1回交換します。
返されたアクセストークン、置き換えリフレッシュトークン、有効期限を原子的に保存してください。
古いリフレッシュトークンを破棄してください。新しいアクセストークンを使用して待機中のリクエストを解放してください。

失敗を処理してください。#

に invalid_grant, 使用できない認可をクリアし、顧客に再接続を依頼してください。一時的なサービスエラーは同意の取り消しとは異なります: 一時的な失敗を表示し、回復のための制限されたパスを維持してください。リフレッシュを無限にループさせないでください。

スコープを狭めるリクエスト#

オプションの scope 値で権限を減らすことができます。ただし、 surcharge アイデンティティ専用の付与に権限を追加することはできません。返されたスコープと有効期限を新しいトークンの権限として使用してください。

次のステップ#

OAuthアクセストークンを使用してチャットリクエストを送信

最終更新日 2026年9月15日