租户实例串流前获取设备的device_token - GetDeviceToken
功能介绍
租户实例串流前获取设备的device_token。
调用此api的前提条件是租户需要先购买实例。
调用该接口获取云机实例的device_token后作为鉴权信息,并携带云机实例的device_id去调用返参中的信令地址(signaling_url)。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/instances/{instance_id}/auth
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instance_id |
是 |
String |
实例id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-auth-token |
是 |
String |
租户的iam token信息 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
data object |
返参全部信息 |
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
sdk |
sdk object |
sdk信息 |
|
rtc |
rtc object |
rtc信息 |
|
device_id |
String |
设备id |
|
kp_id |
String |
云机实例Id,如whklpuo1 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
address |
String |
内网ip地址 |
|
aport |
String |
音频端口 |
|
atype |
String |
音频类型 |
|
address_ipv6 |
String |
ipv6地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
address |
String |
外网eip地址 |
|
aport |
Integer |
音频端口 |
|
atype |
Integer |
音频类型 |
|
address_ipv6 |
String |
外网ipv6地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
signaling_url |
String |
信令服务访问地址 |
|
expired_time |
String |
streaming时长,单位秒 |
|
ice_servers |
Array of strings |
ICE服务器 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
0:成功 KOOPHONE.API.1000:请求参数错误 KOOPHONE.API.1001:没有实例权限 KOOPHONE.API.9999:服务内部报错 |
|
error_msg |
String |
错误信息 |
请求示例
post接口,请求url中携带租户自己购买的实例和租户的token直接调用。
/v1/instances/Q39YyZvI/auth
响应示例
状态码:200
实例鉴权接口返回设备信息
{
"data" : {
"resource" : {
"sdk" : {
"internal" : {
"address" : null,
"aport" : null,
"atype" : null,
"address_ipv6" : null
},
"external" : {
"address" : "10.83.71.187",
"aport" : 10030,
"atype" : 1,
"address_ipv6" : null
}
},
"rtc" : {
"ice_signaling" : {
"signaling_url" : "http://100.93.2.248:18082",
"expired_time" : null,
"ice_servers" : [ ]
}
},
"device_id" : "7b0cd026df8d495b8a65d628d7bec433",
"kp_id" : "Q39YyZvI"
},
"device_token" : "dee5081f40c83ddea3ded91c387351e9"
},
"error_code" : "0",
"error_msg" : "ok"
}
状态码:400
请求错误
{
"error_code" : "string",
"error_msg" : "string"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
实例鉴权接口返回设备信息 |
|
400 |
请求错误 |
错误码
请参见错误码。