メインコンテンツまでスキップ

共通

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

共通 API v3 リファレンスへ移動
バージョン別機能範囲のご案内
  • 国家およびタイムゾーン一覧取得: v3 で新規追加された機能で、v1 および v2 ではサポートされません。
  • 言語一覧取得: すべてのバージョンで言語一覧取得をサポートします。
  • 共通認証: すべてのバージョンの API はクエリストリングパラメーター(?access_token=)による共通認証方式を使用します。エラー判定基準に関する共通仕様は、API v3 移行ガイドの 主な変更点 セクションをご参照ください。

国家一覧取得​

  • 既存 (v1/v2): 非対応
  • 変更後 (v3): GET /countries
リクエストおよびレスポンス構造の詳細

リクエストボディおよびパラメーター​

渡す個別のパラメーター（Path/Query/Body）が存在しない、単純な照会エンドポイントです。

レスポンスフィールド仕様​

フィールドデータ型説明
idInteger国家固有 ID
english_nameString国家名称（英語表記）
native_nameString国家名称（現地語表記）
code_2charStringISO 標準 2 桁国コード（例: kr）
code_3charStringISO 標準 3 桁国コード（例: kor）
short_nameString国家略式名称

レスポンス構造仕様​

{
  "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"
        }
      ]
    }
  ]
}