--- title: "チャンネル Service URLの照会" slug: "media-livestation-channel-serviceurl" updated: 2026-09-17T09:58:13Z published: 2026-09-17T09:58:13Z canonical: "api.ncloud-docs.com/media-livestation-channel-serviceurl" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # チャンネル Service URLの照会 Classic/VPC環境で利用できます。 ライブチャンネルのライブ再生 URL、タイムシフト URL、サムネイル URLを照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v2/channels/{channelId}/serviceUrls | ### リクエストヘッダ Live Station APIで共通して使用されるヘッダの詳細は、[Live Stationのリクエストヘッダ](/docs/ja/media-livestation#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `channelId` | String | Required | チャンネル ID - [チャンネルリストの照会](/docs/ja/media-livestation-channel-channellist)を参照 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `serviceUrlType` | String | Required | Servcie URLタイプ - `GENERAL` \| `TIMEMACHINE` \| `THUMBNAIL` - `GENERAL`: ライブ再生 URL(HLSと MPEG-DASH) - `TIMEMACHINE`: タイムシフト URL。タイムシフト(DVR)を設定したチャンネルが配信中の場合にのみ照会可能 - `THUMBNAIL`: サムネイル画像 URL | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/serviceUrls?serviceUrlType=GENERAL' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'x-ncp-region_code: KR' \ --header 'Content-Type: application/json' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 #### GENERAL ライブ再生 URLリクエスト時のレスポンスボディは次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content` | Array | - | ライブ再生 URL情報: [content](/docs/ja/media-livestation-channel-serviceurl#content1) | #### `content` `content`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `name` | String | - | 画質名 | | `url` | String | - | ライブ再生 URL | | `resolution` | String | - | ビデオ解像度 | | `videoBitrate` | String | - | ビデオストリームのビットレート(bps) | | `audioBitrate` | String | - | オーディオストリームのビットレート(bps) | #### TIMEMACHINE タイムシフト URLリクエスト時のレスポンスボディは次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content` | Array | - | タイムシフト URL情報: [content](/docs/ja/media-livestation-channel-serviceurl#content2) | #### `content` `content`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `name` | String | - | 画質名 | | `url` | String | - | タイムシフト再生 URL | | `resolution` | String | - | ビデオ解像度 | | `videoBitrate` | String | - | ビデオストリームのビットレート(bps) | | `audioBitrate` | String | - | オーディオストリームのビットレート(bps) | #### THUMBNAIL サムネイル画像 URLリクエスト時のレスポンスボディは次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content` | Array | - | サムネイル画像 URL情報: [content](/docs/ja/media-livestation-channel-serviceurl#content3) | #### `content` `content`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `name` | String | - | サムネイル名 | | `url` | String | - | サムネイル画像 URL | | `resizedUrl` | Array | - | リサイズされたサムネイル画像 URLリスト: [resizedUrl](/docs/ja/media-livestation-channel-serviceurl#resizedUrl) | #### `resizedUrl` `resizedUrl`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `type` | String | - | サムネイル画像サイズ | | `url` | String | - | サムネイル画像 URL | ### レスポンスステータスコード Live Station APIで共通して使用されるレスポンスステータスコードの詳細は、[Live Stationのレスポンスステータスコード](/docs/ja/media-livestation#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### GENERAL URLを照会する場合 ライブ再生 URLを照会する場合、レスポンスのサンプルコードは次の通りです。 ``` { "content": [ { "name": "480p-16-9", "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8", "resolution": "854x480", "videoBitrate": "1200000", "audioBitrate": "128000" }, { "name": "360p-16-9", "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8", "resolution": "640x360", "videoBitrate": "800000", "audioBitrate": "96000" }, { "name": "audio-192k", "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8", "audioBitrate": "192000" }, { "name": "ABR", "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/playlist.m3u8" } ] } ``` #### TIMEMACHINE URLを照会する場合 タイムシフト URLを照会する場合、レスポンスのサンプルコードは次の通りです。 ``` { "content": [ { "name": "480p-16-9", "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8", "resolution": "854x480", "videoBitrate": "1200000", "audioBitrate": "128000" }, { "name": "360p-16-9", "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8", "resolution": "640x360", "videoBitrate": "800000", "audioBitrate": "96000" }, { "name": "audio-192k", "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8", "audioBitrate": "192000" }, { "name": "ABR", "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/playlist.m3u8" } ] } ``` #### THUMBNAIL URLを照会する場合 サムネイル URLを照会する場合、レスポンスのサンプルコードは次の通りです。 ``` { "content": [ { "name": "thumbnail", "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/thumbnail.jpg", "resizedUrl": [ { "type": "100px", "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/100px/thumbnail.jpg" }, { "type": "360px", "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/360px/thumbnail.jpg" }, { "type": "720px", "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/720px/thumbnail.jpg" } ] } ] } ```