租户实例串流前获取设备的device_token - GetDeviceToken

功能介绍

租户实例串流前获取设备的device_token。

调用此api的前提条件是租户需要先购买实例。

调用该接口获取云机实例的device_token后作为鉴权信息，并携带云机实例的device_id去调用返参中的信令地址（signaling_url）。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  koophone:cloudphoneResource:executeInstanceAuthToken	Write	cloudphoneResource *	-	-	-

URI

POST /v1/instances/{instance_id}/auth

请求参数

响应参数

状态码：200

状态码：400

请求示例

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"
}

状态码

错误码

请参见错误码。