Service
한국환경공단 전기자동차 충전소 정보 OpenAPI를 기반으로 전국 공공·민간 전기차 충전기 검색, 실시간 상태, 커넥터 타입, 운영기관, 주변 반경 검색을 제공합니다.
98.79%30일 가동률평균 응답560ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-ev-charger/charger-status | Reads the compact real-time charger status feed (available, charging, offline, or under maintenance), optionally scoped by province and by the recent update period in minutes (status_period_minutes, which only takes effect on this operation). Use for lightweight polling of recently changed availability. Do NOT use when full inventory fields (address, coordinates, output kW, connector type) are needed — use korea-ev-charger:search-chargers instead. Returns compact status rows (statuses) with status, ISO-8601 timestamps, and the deprecated status_code (removed after 2026-10-12), plus total_count, filtered_count, scan_count, and scan_exhausted. | |
| POST | /v1/korea-ev-charger/search-chargers | Searches electric vehicle chargers by province, district code, station name, operator, connector type, or live status. Use when callers need inventory or filtered lists of Korean EV chargers with address, coordinates, and output power. Do NOT use for lightweight availability polling — use korea-ev-charger:charger-status instead; for coordinate-and-radius queries use korea-ev-charger:search-chargers-nearby, and for every charger at a known station_id use korea-ev-charger:station-chargers. Province (zcode) and, when given together with a province, district code (zscode) are applied upstream; the other filters are applied client-side while scanning upstream pages. Returns normalized charger rows (chargers) with coordinates, output power in kW, and ISO-8601 status timestamps, plus total_count, filtered_count, scan_count, and scan_exhausted. | |
| POST | /v1/korea-ev-charger/search-chargers-nearby | Finds EV chargers near a WGS84 coordinate within a radius, scoped by the required province. Upstream has no native geo endpoint, so by default this operation pages through the full province inventory (upstream ordering is operator-grouped, not spatial) and ranks rows by haversine distance in meters. The nearest results are complete unless scan_limit is lowered (disclosed via scan_exhausted=false). Use for map and navigation style nearby queries when a coordinate is available. Do NOT use without a coordinate — use korea-ev-charger:search-chargers for region, name, or operator filters instead. Returns chargers sorted by distance_meters ascending, plus total_count, scan_count, scan_limit, and scan_exhausted. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-ev-charger/station-chargers | Lists every charger installed at one charging station using the upstream native statId lookup (single upstream call); the required province input is verified against the returned rows. Use when a caller already has a station_id from search results and needs all connector rows for that station. Do NOT use to discover stations by name or region — use korea-ev-charger:search-chargers first, or korea-ev-charger:search-chargers-nearby when starting from a coordinate. Returns station_id, station_name, chargers (all charger rows for the station, paginated), total_count, page, and limit. |
