获取直播流信息

获取当前直播间的推流地址信息。

请求说明

• 接口名称：GetStreamsAPI
• 请求方式：GET
• 接口地址：http://livesaas.volcengineapi.com/?Action=GetStreamsAPI&Version=2020-06-01
• 请求频率：单用户请求频率限制为 120 次/分钟。

请求参数

以下请求参数列表仅列出了该接口的部分公共参数，完整公共参数列表见公共请求参数。

Query

返回参数

LineDetails

PushInfo

ForwardInfo

示例

请求示例

Get http://livesaas.volcengineapi.com/?Action=GetStreamsAPI&Version=2020-06-01&ActivityId=1231231231

正常返回示例

{
		"ResponseMetadata":{
				"RequestId":"202201201826170101501312091D1C09D2",
				"Action":"GetStreamsAPI",
				"Version":"2020-06-01",
				"Service":"livesaas",
				"Region":"cn-north-1",
				"SystemTime":1656067132
		},
		"Result":{
				"LineDetails":[
						{
								"LineId":123,
								"LineName":"线路1",
								"MainPushInfo":{
										"PushPath":"https://example-livesaas.com/example",
										"StreamingCode":"livesaas?key=example",
										"PushUrl":"https://example-livesaas.com"			
								},
								"BackPushInfo":{
										"PushPath":"https://example-livesaas.com/example",
										"StreamingCode":"livesaas?key=example",
										"PushUrl":"https://example-livesaas.com/livesaas?key=example"	
								},
								"Ratio": "1920*1080",
								"ForwardInfo":{
										"PullStreamUrl":"https://example/livesaas?key=example",
										"PullStreamStatus":1,
										"PullStreamCheckStatus":1																
								},
								"BackupForwardInfo":{
										"PullStreamUrl":"https://example/livesaas?key=example",
										"PullStreamStatus":1,
										"PullStreamCheckStatus":1																
								},
								"ExpireTime":1643004493				
						}
				]    
		}
}

异常返回示例

{
		"ResponseMetadata":{
				"RequestId":"201806041104200100100232280022D30",
				"Action":"GetStreamsAPI",
				"Version":"2020-06-01",	
				"Service":"livesaas",
				"Region":"cn-north-1",
				"SystemTime":1656067132,
				"Error":{
						"Code":"200000",
						"Message":"参数异常"
				}
		}
}

错误码

访问公共错误码获取详细信息。