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