모든 소스라이브 Open API 에 공통으로 적용되는 형식입니다.
성공 응답
HTTP 200 과 함께 data 를 돌려줍니다. 시계열 API 에만 meta.interval 이 함께 옵니다.
{ "data": { ... } }
{ "data": [ ... ], "meta": { "interval": "P1D" } }| 항목 | 규칙 |
|---|---|
data | 객체 또는 배열. 결과가 없으면 빈 배열 [] |
meta.interval | 시계열 API 에서만. PT1M, PT10M, PT1H, P1D 중 하나. 그 외 API 는 meta 키가 없습니다 |
| 값 없음 | 필드가 null 일 수 있습니다. 0 으로 바꾸지 않습니다 |
| 새 필드 | 예고 없이 추가될 수 있습니다. 모르는 필드는 무시하도록 구현해 주세요 |
날짜 · 시간
| 항목 | 규칙 |
|---|---|
| 형식 | ISO-8601 UTC, Z 로 끝남. 예: 2026-10-12T15:00:00Z. 초 단위까지 |
| 응답 시각 | 모두 UTC Z 문자열 |
| 하루 경계 | 통계의 하루는 KST(Asia/Seoul) 기준. KST 00:00 = UTC 전날 15:00:00Z |
요청 추적 ID (X-Request-Id)
모든 응답(성공·오류·429 포함)의 헤더에 X-Request-Id 가 붙습니다. 요청 하나마다 다른 값입니다.
| 항목 | 규칙 |
|---|---|
| 응답 헤더 | 항상 X-Request-Id 를 돌려줍니다. 오류 응답 본문의 traceId 와 같은 값입니다 |
| 요청 헤더 (선택) | 직접 X-Request-Id 를 보내면 그 값을 그대로 씁니다. 자사 시스템 로그와 맞춰 보고 싶을 때 쓰세요 |
| 허용 형식 | 영문·숫자·- _ . : 로 된 128자 이하. 형식이 다르거나 보내지 않으면 새 값을 만들어 돌려줍니다 |
| 문의 | 응답이 이상하거나 오류가 나면 이 값을 함께 알려 주세요. 해당 요청을 바로 찾을 수 있습니다 |
X-Request-Id: 3f9c2a7e-5b1d-4c8a-9e6f-2d7b8a1c4e90
버전
- 현재 버전은
2026-10-28이며x-api-version헤더는 필수입니다. - 하위 호환이 깨지는 변경이 있을 때만 새 날짜 버전을 만들고, 이전 버전은 최소 12개월 지원합니다.
정렬
정렬 파라미터는 없습니다. 각 API 페이지에 고정된 정렬 순서를 적어 두었습니다.
