공통

공통 API v3 레퍼런스 바로가기→

버전별 기능 범위 안내

• 국가 및 타임존 목록 조회: v3에 신규 추가된 기능으로, v1 및 v2에서는 지원하지 않습니다.
• 언어 목록 조회: 모든 버전에서 언어 목록 조회를 지원합니다.
• 공통 인증: 모든 버전의 API는 쿼리 스트링 파라미터(?access_token=)를 통한 공통 인증 방식을 사용합니다. 에러 판정 기준에 대한 공통 명세는 API v3 마이그레이션 가이드의 핵심 변경 사항 섹션을 참고하세요.

---

국가 목록 조회

• 기존 (v1/v2): 미지원
• 변경 (v3): GET /countries

요청 및 응답 구조 상세

요청 본문 및 파라미터

전달할 별도의 파라미터(Path/Query/Body)가 존재하지 않는 단순 조회 엔드포인트입니다.

응답 필드 명세

필드	데이터 타입	설명
id	Integer	국가 고유 ID
english_name	String	국가 명칭 (영문 표기)
native_name	String	국가 명칭 (현지 언어 표기)
code_2char	String	ISO 표준 2자리 국가 코드 (예: kr)
code_3char	String	ISO 표준 3자리 국가 코드 (예: kor)
short_name	String	국가 약식 명칭

응답 구조 명세

{
  "data": [
    {
      "id": 115,
      "english_name": "Korea, Republic of",
      "native_name": "대한민국",
      "code_2char": "kr",
      "code_3char": "kor",
      "short_name": "South Korea"
    }
  ]
}

---

언어 목록 조회

• 기존 (v1): GET /media/subtitle/languages
• 기존 (v2): GET /vod/languages
• 변경 (v3): GET /languages

---

타임존 목록 조회

• 기존 (v1/v2): 미지원
• 변경 (v3): GET /timezones

요청 및 응답 구조 상세

요청 본문 및 파라미터

전달할 별도의 파라미터(Path/Query/Body)가 존재하지 않는 단순 조회 엔드포인트입니다.

응답 구조 명세

대륙별 그룹화가 적용된 2단계 중첩 JSON 객체 구조로 데이터를 반환합니다.

{
  "data": [
    {
      "name": "Asia",
      "timezones": [
        {
          "key": "Asia/Seoul",
          "value": "Seoul, UTC+09:00"
        }
      ]
    }
  ]
}