문서
요청 한도와 오류
모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 들어 있어, 한도를 맞닥뜨리는 대신 다가오는 것을 볼 수 있습니다.
할당량
무료 키는 하루 100회이며 UTC 자정에 초기화됩니다. 다음 날 그대로 이어지고 갱신할 것은 없습니다. Pro는 하루 5,000회, Business는 25,000회, Enterprise는 공정 사용 범위에서 무제한입니다.
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1761264000| status | meaning |
|---|---|
| 200 | A normal answer. Check X-RateLimit-Remaining while you are here. |
| 400 | A parameter could not be parsed — a non-numeric yearFrom, for instance. |
| 401 | Missing or unknown key. Send it as the x-api-key header. |
| 404 SOLD_OR_REMOVED | From /car: the vehicle is gone from Encar. Drop it on your side. |
| 429 | Daily allowance spent. X-RateLimit-Remaining tells you before it happens. |
| 503 | The Korean source did not answer in time. Retry once, then fall back. |
판매된 차량 처리하기
코드를 작성할 가치가 있는 오류입니다. GET /car는 판매 여부를 실시간으로 확인하므로, 엔카를 떠난 차량은 SOLD_OR_REMOVED 코드와 함께 404로 답합니다. 재시도할 실패가 아니라 내 쪽에서 게시를 내리라는 신호로 다루세요. 내일 다시 같은 404가 돌아옵니다.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }API 키 받기
무료 · 하루 100회 요청
이어서 읽기
검색 파라미터 — GET /cars
한 번의 호출에서 자유롭게 조합할 수 있습니다. 응답에 total, page, count, results[]가 있으므로 두 번째 요청 없이 total로 페이지를 넘길 수 있습니다.
더 읽기 →
매물은 이렇게 생겼습니다
데이터가 한국어 원본에서 오기 때문에 이 중 네 필드는 기본적으로 잘못 읽힙니다. 모두 조용히 실패합니다. 페이지는 잘 그려지고, 다만 틀립니다.
더 읽기 →
Encar API 요금: 무료 키, 이후 정액 월 요금제
월 단일 금액, 예측해야 할 호출당 과금 없음, 설치비 없음. 무료 플랜은 만료되는 체험판이 아니라 진짜 플랜입니다.
더 읽기 →