チャンネルの作成

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

Live Stationの Re-Streamチャンネルを作成する APIです。作成した Re-Streamチャンネルを照会するためのチャンネルリスト照会の APIとチャンネル情報照会の APIを提供します。

リクエスト

POST https://livestation.apigw.ntruss.com/api/v2/re-stream/channels

リクエストヘッダ

ヘッダ名	必須有無	説明
x-ncp-apigw-timestamp	YES	1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	NAVERクラウドプラットフォームポータルから発行された Access Key ID値 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID値と Secret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	YES	Request body content typeを application/jsonに指定 `Content-Type: application/json`
x-ncp-region_code	YES	リージョンコード(KR)

リクエストボディ

フィールド名	必須有無	タイプ	制限事項	説明
channelName	Yes	String	最低3文字以上、最大20文字まで入力可能。記号の「_」を許可	作成するチャンネル名
envType	Optional	String	DEV, STAGE, REAL	作成するチャンネルの使用区分のための設定です。入力しない場合は REALに設定
planType	Yes	String	STANDARD, PROFESSIONAL
restream	Yes	Object[]
restream[].targetName	Yes	String	YOUTUBE, CHZZK, STEAM, YOUNOW, USTREAM, AFREECATV, PRISM, CUSTOM	re-streamするプラットフォーム名
restream[].rtmpUrl	Yes	String
restream[].streamKey	Yes	String
restream[].id	No	String		RTMP認証 ID
restream[].password	No	String		RTMP認証 Password

レスポンス

フィールド名	タイプ	説明	備考
channelId	String
channelName	String
envType	String	DEV, STAGE, REAL
instanceNo	Integer
channelStatus	String	CREATING, READY, PUBLISH, DELETED, BLOCK, FORCE_BLOCK, FORCE_DELETED
createdTime	Integer
streamKey	String
publishUrl	String
globalPublishUrl	String		海外配信対応のための URL
planType	String	STANDARD, PROFESSIONAL
restream	Object[]
restream[].targetName	String
restream[].rtmpUrl	String
restream[].streamKey	String
restream[].id	String
restream[].password	String
platformCount	Integer
totalPublishSeconds	Integer
alertOn	Boolean
isPublishing	Boolean

例

リクエスト例

POST /api/v2/re-stream/channels
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

{
   "channelName":"myrestream",
   "planType":"STANDARD",
   "restream":[
      {
         "targetName":"YOUTUBE",
         "rtmpUrl":"rtmp://notworking-just-testcase.only"
      },
      {
         "targetName":"TWITCH",
         "rtmpUrl":"rtmp://notworking-just-testcase.only",
         "streamKey":"12345",
         "id":"itisid",
         "password":"itispassword"
      }
   ]
}

レスポンス例

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 2 Mar 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
   "content":{     
      "channelId":"ls-20200327014626-Nh91v",
      "channelName":"myrestream",
      "instanceNo":1168812,
      "channelStatus":"READY",
      "createdTime":1585241186000,
      "streamKey":"7hdxzm1d1234du3qs",
      "publishUrl":"rtmp://live-station-rtmp-url",
      "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
      "planType":"STANDARD",
      "restream":[        
         {
            "targetName":"YOUTUBE",
            "rtmpUrl":"rtmp://notworking-just-testcase.only"
         },
         {
            "targetName":"TWITCH",
            "rtmpUrl":"rtmp://notworking-just-testcase.only",
            "streamKey":"12345",
            "id":"itisid",
            "password":"itispassword"
         }
      ],
      "platformCount":2,
      "totalPublishSeconds":0,
      "alertOn":false,
      "isPublishing":false,
      "envType": "REAL"
   }
}

この記事は役に立ちましたか?

What's Next

チャンネル削除

リクエスト
レスポンス
例

タグ

Live Station