エラー

エラーオブジェクト

すべての失敗は、原因が何であれ同じ形式です:

403
{
  "error": {
    "code": "scope_required",
    "message": "This key is not allowed to perform that action.",
    "details": {
      "scope": "keywords:write"
    }
  },
  "request_id": "req_d3428e686099bb0e"
}

code

ステータスcode意味
401missing_api_keyキーが送られていません
401invalid_api_keyそのようなキーはありません。タイプミスを確認してください
401key_revokedキーは存在しましたが失効しています。発行者に相談してください
402plan_limitプランの上限に達しました。details.resource は targets または keywords で、limit と current を伴います
403scope_requiredキーにスコープが不足しています。details.scope がそのスコープを示します
404not_subscribedそのアカウントを監視していません。解決に失敗した場合は details.state: "failed"、details.reason、details.failed_at が付きます
404user_not_foundX にそのアカウントはありません(未登録、削除済み、または停止済み)
404user_suspendedX がこのアカウントを凍結しています
404user_protectedこのアカウントの投稿は非公開(承認したフォロワーのみ)のため、監視できません
404tweet_not_foundそのような投稿はないか、削除されています
404not_foundそのようなリソースはありません
409idempotency_key_reuse同じ Idempotency-Key がすでに別のリクエストで使われています
409conflictリソースがその変更を許さない状態にあります。details.reason が理由を示します
422invalid_requestボディまたはクエリがバリデーションに失敗しました。422 の場合は details.fields が問題のある各フィールドを示し、400 の場合はパースはできたが受け付けられない値です
429rate_limited毎分のリクエスト枠を使い切りました。Retry-After が再開時刻を示します
429quota_exhaustedその読み取りに対する上流の制限に達しました。Retry-After が再開時刻を示します
502upstreamX が期待どおりに応答しませんでした。通常は一時的なので、リトライしてください
500internal当社側の問題です。request_id をお送りください