認証
レート制限とエラー
Signal Foundry API のレート制限と、代表的なエラーコードの見方をまとめます。
このページの内容2項目
API キー利用時には plan quota と request-based rate limit が適用されます。
現在の Company-first product quota は次です。
| Plan | Search | Company Card | Deep Signal | RPM | Result limit |
|---|---|---|---|---|---|
| Free | 1,000/day | 2,000/day | 200/day | 120 | 50 |
| Pro | 5,000/month | 10,000/month | 1,000/month | 300 | 100 |
Credit Pack は credit 残高だけを増やします。plan quota、RPM、batch 上限、検索結果上限は増やしません。
上限を超えると 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 | 利用範囲 の指定が衝突している |
company_not_found | 指定した会社が解決できない |
filing_not_found | 指定した filing が見つからない |
compare_target_not_found | 比較先の filing が見つからない |
daily_*_quota_exceeded / monthly_*_quota_exceeded | plan quota を超過した |
credit_balance_insufficient | credit 残高が不足している |
運用のコツ
- smoke 用と本運用用でキーを分ける
- エージェントごとにキーを分ける
- 429 が出たら、まず同一キーの使い回しを疑う
- quota error が出たら
sf usage --jsonで残りと reset を確認する - credit error が出たら
sf credits balance --jsonで残高を確認する
このエラーモデルは 現在の会社層 の 読み取り API を前提にしています。将来の別 product object では、追加の error code が増える可能性があります。