API03005: レート制限を超えました
これが意味すること
短期間でサーバーに対してリクエストを多く行いすぎました。レート制限は、サーバーが過負荷になるのを防ぎます。
一般的な原因
- 急速な同期操作 — 複数のデバイスが同時に同期している
- 攻撃的なリフレッシュ — データを頻繁にリフレッシュしすぎる
- セキュリティプラグイン — プラグインがリクエスト制限を課している
- ホスティングの制限 — ホスティングプランにAPIレート制限がある
サーバーエラーのマッピング
このエラーコードは、サーバーが次のように返したときにトリガーされます：
| サーバーコード | ソース |
|---|---|
| HTTP 429 | 任意のサーバーレスポンス（フォールバック） |
修正方法
1. 待機して再試行
レート制限は一時的です：
- 1〜5分待つ
- POSが自動的に再試行します
- 手動で何度もリフレッシュしないようにする
2. 同時操作を減らす
複数のPOS端末を使用している場合：
- デバイス間で初期同期をずらす
- すべてのデバイスを一度にリフレッシュしない
- 一つが完了するまで別の作業を始めない
3. セキュリティプラグインを確認する
Wordfenceのようなプラグインが急速なリクエストをブロックする可能性があります：
- POSアプリケーションをホワイトリストに追加する
- POSデバイスのIPをホワイトリストに追加する
- レート制限のしきい値を調整する
4. ホスティングの制限を確認する
一部のホスティングではAPIリクエストに制限があります：
- ホスティングプランの詳細を確認する
- 制限が低すぎる場合はアップグレードを検討する
- 制限を増やすためにサポートにお問い合わせください
5. 同期頻度を最適化する
POS設定で：
- 自動リフレッシュの間隔を調整する
- 適切な場合に手動同期を使用する
- 不要なデータのリフレッシュを避ける