오류 — javinfo

javinfo API가 반환하는 HTTP 상태 코드 및 오류 응답 본문 형식입니다.

오류는 표준 HTTP 상태 코드를 사용합니다. 실패한 요청은 청구되지 않습니다 — 성공적인 200 응답에 대해서만 비용을 지불합니다.

상태 코드

상태	의미
`400`	잘못된 요청 — 알 수 없는 제공업체 ID 또는 인증된 세션에서 키 누락.
`401`	API 키가 없거나 유효하지 않음.
`402`	잔액 부족 — 계정을 충전하세요. 요금 참조.
`404`	결과를 찾을 수 없음 (모든 제공업체가 미스, 또는 `/random`의 인덱스가 비어 있음).
`429`	속도 제한 또는 일일 할당량 초과. `Retry-After` 헤더 이후에 재시도하세요.
`499`	제공업체가 응답하기 전에 클라이언트가 요청을 종료했습니다.

오류는 기계가 읽을 수 있는 code와 사람이 읽을 수 있는 message가 포함된 JSON 본문을 반환합니다:

{
  "code": "NOT_FOUND",
  "message": "No result found for \"SSIS-999\"."
}

속도 제한에 도달하면 Retry-After 응답 헤더(초)를 사용하여 백오프하세요:

if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 1);
  await new Promise((r) => setTimeout(r, wait * 1000));
}