OPEN API 3.1

수열에너지원 데이터와 분석 기능을 개방합니다

표준 응답, 커서 페이지네이션, BBOX 필터와 명확한 오류 형식으로 WebGIS 데이터를 연계할 수 있습니다.

공개 조회

건강상태, 코드, 데이터셋, 메타데이터와 저해상도 지역 집계

GET /health · /codes · /datasets · /metadata · /summary

상세 공간자료

API 키와 할당량이 적용되는 격자, 시설, 관측과 분석결과

GET /grids · /facilities · /observations · /potentials · /economics

비동기 분석

승인된 모델·K-ATB·시나리오로 잠재량과 경제성 작업 생성

POST /analysis/potential · /analysis/economics

다운로드

요청자에게 격리된 CSV·Excel·GeoJSON 내보내기 작업

POST /downloads · GET /downloads/{id}/file

인증

상세 조회·분석·다운로드는 발급된 API 키를 X-API-Key 또는 Bearer 헤더로 전달합니다. 키는 최초 발급 시 한 번만 표시됩니다.

응답과 좌표계

  • • 성공: data, meta, links
  • • 오류: error.code, message, details, requestId
  • • GeoJSON: EPSG:4326
  • • 내부 공간분석: EPSG:5179
OpenAPI YAML 열기

공개 API 시험

브라우저에서 안전한 공개 GET 요청만 실행합니다.

공개 API

요청 URL

/api/v1/health
요청을 실행하면 상태·헤더·응답 본문이 표시됩니다.