メインコンテンツにスキップ
バージョン: 1.x

API02009: リフレッシュトークンが期限切れ

これは何を意味しますか

リフレッシュトークンの有効期限が切れ、新しいアクセストークンを取得するために使用できなくなりました。アクセストークンは(すぐに期限切れになりますが)、リフレッシュトークンは通常、数日または数週間持続しますが、最終的には期限切れになります。

よくある原因

  • 長期間の非アクティブ — POSを長い間使用していない
  • 短いトークンの有効期間 — 短いリフレッシュトークンの有効期限でサーバーが設定されている
  • 時計のずれ — デバイスまたはサーバーの時間が大幅にずれている

修正方法

1. 再度ログインする

リフレッシュトークンが期限切れになると、再度認証する必要があります:

  1. POSからログアウトする
  2. 認証情報を入力する
  3. 新しいリフレッシュトークンが発行されます

2. POSを定期的に使用する

将来これを避けるために:

  • トークンを新鮮に保つためにPOSを定期的に使用する
  • アクティブな時にトークンは自動的に更新されます
  • 長期間の非アクティブ状態は再ログインを必要とします

3. 時間設定を確認する

すべてのシステムで正確な時間を確保してください:

  • デバイスで自動的な時間同期を有効にする
  • サーバーの時間が正しいことを確認する
  • 時間の違いは早期の期限切れを引き起こす可能性があります

4. トークンの有効期間を調整する(上級)

トークンが必要な時間よりも早く期限切れになる場合、サーバーの管理者が認証設定でリフレッシュトークンの有効期限を調整できます。

関連エラー

  • API02002 — トークンが期限切れ
  • API02007 — トークンの更新に失敗しました