오류

오류 객체

원인이 무엇이든 모든 실패는 같은 형태입니다:

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	의미
401	`missing_api_key`	키가 전송되지 않았습니다
401	`invalid_api_key`	그런 키가 없습니다. 오타를 확인하십시오
401	`key_revoked`	키가 존재했지만 폐기되었습니다. 발급한 사람에게 문의하십시오
402	`plan_limit`	플랜 상한에 도달했습니다. `details.resource`는 `targets` 또는 `keywords`이며 `limit`과 `current`가 함께 옵니다
403	`scope_required`	키에 스코프가 없습니다. `details.scope`가 어느 것인지 알려줍니다
404	`not_subscribed`	해당 계정을 모니터링하고 있지 않습니다. 조회에 실패한 경우 `details.state: "failed"`, `details.reason`, `details.failed_at`이 추가됩니다
404	`user_not_found`	X에 그런 계정이 없습니다. 가입한 적이 없거나, 삭제되었거나, 비활성화되었습니다
404	`user_suspended`	X가 이 계정을 정지했습니다
404	`user_protected`	이 계정의 게시물은 비공개(승인된 팔로워만)이므로 모니터링할 수 없습니다
404	`tweet_not_found`	그런 게시물이 없거나, 삭제되었습니다
404	`not_found`	그런 리소스가 없습니다
409	`idempotency_key_reuse`	같은 `Idempotency-Key`가 이미 다른 요청에 사용되었습니다
409	`conflict`	리소스가 변경을 허용하지 않는 상태입니다. `details.reason`이 이유를 알려줍니다
422	`invalid_request`	본문 또는 쿼리가 유효성 검사에 실패했습니다. `422`인 경우 `details.fields`가 문제 있는 각 필드를 알려주고, `400`인 경우 파싱은 됐지만 받아들일 수 없는 값입니다
429	`rate_limited`	분당 요청 예산을 모두 사용했습니다. `Retry-After`가 언제 재시도할지 알려줍니다
429	`quota_exhausted`	해당 읽기에 대한 업스트림 제한에 도달했습니다. `Retry-After`가 언제 재시도할지 알려줍니다
502	`upstream`	X가 예상대로 응답하지 않았습니다. 대개 일시적이므로 재시도하십시오
500	`internal`	저희 잘못입니다. `request_id`를 보내주십시오