認証
レート制限とエラー
Signal Foundry API のレート制限と、代表的なエラーコードの見方をまとめます。
このページの内容2項目
API キー利用時には request-based rate limit が適用されます。
current default は次です。
- minute:
60 - day:
10000 - heavy day:
2000
day は全 API request の rolling 24h limit です。heavy day は GET /api/signal-foundry/companies と POST /api/signal-foundry/observations/search だけを count する追加の rolling 24h limit です。
ただし運用ポリシーで将来変更する可能性があります。
上限を超えると 429 rate_limit_exceeded を返します。レスポンスには次が含まれます。
Retry-Afterヘッダーerror.rate_limit.windowerror.rate_limit.limiterror.rate_limit.remaining
よくあるエラー
| Code | 意味 |
|---|---|
invalid_api_key | API キーが見つからない |
api_key_revoked | revoke 済み |
api_key_rotated | rotate 済みで新キーへ切り替え済み |
api_key_expired | 有効期限切れ |
account_scope_conflict | account scope の指定が衝突している |
company_not_found | 指定した会社が解決できない |
filing_not_found | 指定した filing が見つからない |
compare_target_not_found | 比較先の filing が見つからない |
運用のコツ
- smoke 用と本運用用でキーを分ける
- agent ごとにキーを分ける
- 429 が出たら、まず同一キーの使い回しを疑う
このエラーモデルは current company layer の read API を前提にしています。将来の list layer や別 product object では、追加の error code が増える可能性があります。