API 요금제

자주 묻는 질문

한도는 어떻게 계산되나요?

행이 아니라 요청 단위입니다. 반환되는 차량 수와 관계없이 호출 한 번이 1단위이므로, 페이지를 크게 해도 추가 비용이 없습니다.

한도에 도달하면 어떻게 되나요?

일일 구간이 바뀔 때까지 요청이 HTTP 429로 거부됩니다. 대기열에 쌓이거나 초과 요금이 청구되지 않습니다.

무료 사용 시 필드가 숨겨지나요?

아니요. 모든 요금제가 원본 매물 링크를 포함한 모든 필드를 받습니다. 요금제는 사용량과 위에 나열된 기능에서 차이가 납니다.

판매된 차량도 반환되나요?

네. API는 시장에서 빠진 매물을 포함해 전체 카탈로그를 제공합니다. 가격에는 그 이력이 필요하기 때문입니다. 현재 매물만 원하면 available_only=true를 추가하세요.

요금제에 따라 볼 수 있는 마켓플레이스가 제한되나요?

아니요. 모든 키가 모든 마켓플레이스를 봅니다. 계산기에서 고른 마켓플레이스는 가격과 한도를 정할 뿐, API 응답 내용은 바꾸지 않습니다.

매물은 얼마나 최신인가요?

마켓플레이스마다 다릅니다. 차량마다 last_seen_at, 출처마다 last_parsed_at이 있으니 추정치 대신 이 값을 확인하세요.

인증은 어떻게 하나요?

X-API-Key 헤더에 키를 넣거나 Authorization에 Bearer 토큰으로 보내세요. 쿼리 문자열에는 절대 넣지 마세요.

요청이 HTTP 400으로 거부된 이유는?

알 수 없는 파라미터는 무시되지 않고 거부되며, 응답에 대신 쓸 파라미터 이름이 표시됩니다. 전체 목록은 API 레퍼런스에 있습니다.