GuidesAPI GuideChangelog
Log In
API Guide

요청 · 응답 규칙

모든 소스라이브 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 페이지에 고정된 정렬 순서를 적어 두었습니다.

🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.