ライブ履歴取得API過去のライブ開催時の設定情報を取得できるAPIです。
■API呼び出しURL
https://api01-platform.stream.co.jp/apiservice/live/v1/profile/arch/?token=xxxx&各パラメータ
※xxxxはReadAPIのトークンになります。
トークンの確認方法は「■Token情報確認方法について」をご参照ください。
■メソッドタイプ
GET
■パラメータ
| 項目名 | 必須 | 説明 | フォーマット | デフォルト値 |
| token | ○ | アカウント（CID）毎に 発行されたトークン |
文字列 | 無し |
| type | --- | 返却形式のタイプを指定 「jsonp」「json」が指定可能 |
文字列 | json |
| callback | --- | JSONPコールバック関数名 ※jsonp時のみ有効 |
文字列 | searchResultEq |
| pageSize | --- | 取得する件数 | 半角数字 （上限100） |
10 |
| pageNumber | --- | 取得を開始するページ番号 | 半角数字 | 1 |
| lpid | --- | 取得するライブプロファイルのID 「,」区切りで指定することで 複数指定可能 |
半角数字 | 無し |
| eventDateFrom | --- | 取得するライブの開催日期間：開始 ※26ヶ月以前は指定不可 （エラーコード：1026） |
YYYYMMDD形式 YYYY/MM/DD形式 YYYY-MM-DD形式 |
無し |
| eventDateTo | --- | 取得するライブの開催日期間：終了 | YYYYMMDD形式 YYYY/MM/DD形式 YYYY-MM-DD形式 |
無し |
| liveName | --- | ライブ設定名 ※部分一致 |
文字列 | 無し |
| eventName | --- | ライブイベント名 ※部分一致 |
文字列 | 無し |
| p1,p2,p3 | --- | 指定の引数を戻り値として そのまま返却 |
文字列 | 無し |
| resObject | --- |
下記のレスポンスはリクエスト時にのみ返却
上記以外の文字列の場合は、エラーコード（1037：resObjectが不正）を返却 |
文字列 | 無し |
■レスポンス
| 項目名 | 名称 | 備考 | |||
| response_status | APIレスポンスステータス | 「レスポンスステータス」を参照 | |||
| livesum ※ | ライブ履歴全件数 | ||||
| events |
lplid | ライブログID | |||
| status | ライブステータス |
Waiting:録画待機中 Recording:録画中 RecordExtending:録画延長処理中 RecordStoping:録画停止処理中 RecordComp:録画終了 MasterConverting:マスター変換中 MasterConvertComp:マスター変換完了 Transcoding:トランスコード中 TranscodeComp:トランスコード完了 MasterConvertError:マスター変換エラー VODUploadError:VODアップロードエラー VODTranscodeError:VODトランスコードエラー Error:不明なエラー |
|||
| rec_mids | 録画動画ID | ||||
| live_name | ライブ配信設定名 | ||||
| event_name | ライブイベント名 | ||||
| event_onair | ライブイベント開催日時 | yyyy/MM/dd hh:mm:ss | |||
| event_offair | ライブイベント終了日時 | yyyy/MM/dd hh:mm:ss | |||
| live_description | ライブ設定説明 | ||||
| group_id | グループ設定 （録画ファイルアップロード先） |
||||
| mpid | トランスコード設定 | ||||
| max_client | 同時接続数制限 |
0：無制限（unlimited live edtionでのみ利用可能） その他数値：同時接続数 |
|||
| liveapp_flg | EQライブキャスト利用 |
1：利用する 0：利用しない |
|||
| vod_flg | VODの使用可否 |
1：有効 0：無効 |
|||
| exlink ※ | enabled | 関連リンク利用可否 |
1：有効 0：無効 |
||
| settings | index | 関連リンク番号（1～3） | |||
| text | リンクテキスト | ||||
| url | リンクURL | ||||
| vlpid | セキュリティプロファイルID | ||||
| chat ※ |
enabled | チャット設定利用可否 |
0:利用しない 1:利用する |
||
| status | チャットステータス |
streaming：チャット中 stop：チャット停止中 no_setting：チャット使用なし |
|||
| auto_resize_flg | 自動リサイズ |
0:無効 1:有効 |
|||
| width | 表示サイズ - width | ||||
| height | 表示サイズ - height | ||||
| enter_msg | 入退室メッセージの表示 |
0:表示する 1:入室メッセージのみ表示する 2:表示しない |
|||
| good_btn | [いいね]ボタン表示 |
0:無効 1:有効 |
|||
| trouble_btn | [わかりません]ボタン表示 |
0:無効 1:有効 |
|||
| admin_displayname | 管理者表示名 |
管理者 運営 事務局 |
|||
| block_type | 投稿されるメッセージ管理 |
0:メッセージをすべて許可する 1:不適切な可能性のあるメッセージを保留して確認する 2:すべてのメッセージを保留して確認する |
|||
| block_words | ブロックする文字列 | ||||
| open_timing | チャット 開始タイミング（分） |
-1：手動で開始 0：ライブ開始と同タイミング |
|||
| close_timing | チャット 終了タイミング（分） |
-1：手動で終了 0：ライブ終了と同タイミング その他数値：ライブ終了後、○分後に終了 |
|||
| icon_texts |
id | リアクションアイコン（複数） | |||
| active_flg | 利用フラグ |
1：有効 0：無効 |
|||
| text | ボタンの文字 | ||||
| portal_meta ※ |
event_name | イベント名 | |||
| description |
イベント説明 | ||||
| performer | 出演者 | ||||
| desktop_encoder | デスクトップ配信 |
1：有効 0：無効 |
|||
| lqpid | ライブ自動画質ID | ||||
| encrypt | 暗号化配信 | 1：有効
0：無効 |
|||
| dvr | ライブDVR機能利用有無 |
1：有効 0：無効 |
|||
| dvr_close_minutes | ライブ終了後のDVR配信有効期間（分） |
1：即時無効化 それ以外：任意時間後無効化 |
|||
| dvr_close_date | ライブDVR終了時刻（分） | DVRによるライブ映像の巻き戻し機能が使えなくなる時刻 | |||
※リクエスト時に「resObject」で指定した場合のみ返却となります。
■レスポンス例：正常時
|
{ "response_status": "2000",
"livesum": 1,
"events": [
{
"lplid": "XXX-1",
"rec_mids": [
"XXXX"
],
"status": "TranscodeComp",
"live_name": "～部分一致～",
"event_name": "test",
"event_onair": "2020/05/12 11:00:00",
"event_offair": "2020/05/12 12:00:00",
"live_description": "",
"group_id": 0,
"mpid": 16,
"max_client": 2022,
"liveapp_flg": 0,
"vod_flg": 1,
"exlink": {
"enabled": 1,
"settings": [
{
"index": 1,
"text": "",
"url": ""
},
{
"index": 2,
"text": "",
"url": ""
},
{
"index": 3,
"text": "",
"url": ""
}
]
},
"vlpid": 0,
"server_number": 2,
"chat": {
"enabled": 0,
"auto_resize_flg": 0,
"width": 600,
"height": 400,
"enter_msg": 0,
"good_btn": 0,
"trouble_btn": 0,
"admin_display_name": "管理者",
"block_type": 0,
"block_words": [
"ngword"
],
"open_timing": 0,
"close_timing": 0,
"icon_texts": [
{
"id": 1,
"active_flg": 1,
"text": "アイコン"
}
]
},
"portal_meta": {
"event_name": "イベント名",
"description": "イベント説明",
"performer": "田中"
},
"desktop_encoder": 0,
"lqpid": 1,
"encrypt": 1,
"dvr": 1,
"dvr_close_minutes": 1,
"dvr_close_date": "2021/12/07T14:07:50.123"
}
]
}
|
■レスポンス例：エラー時
|
{ |