Help Center/ CloudDevice/ API Reference/ APIs/ Instance Management/ Obtaining device_token Before Streaming
Updated on 2025-10-30 GMT+08:00
View PDF
Share

Obtaining device_token Before Streaming

Function

This API is used for the tenant instance to obtain device_token before streaming.

Before calling this API, ensure that the tenant has purchased an instance.

The obtained device_token of the cloud phone instance is used as the authentication information and carries device_id to call the signaling address (signaling_url) in the response parameter.

URI

POST /v1/instances/{instance_id}/auth

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

instance_id

Yes

String

Instance ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

IAM token information of the tenant.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

data

data object

All response parameter information.

error_code

String

Error code.

error_msg

String

Error message.
Table 4 data

Parameter

Type

Description

resource

resource object

Resource set.

device_token

String

Device authentication token.
Table 5 resource

Parameter

Type

Description

sdk

sdk object

SDK information.

rtc

rtc object

RTC information.

device_id

String

Device ID.

kp_id

String

Cloud phone instance ID, for example, whklpuo1.
Table 6 sdk

Parameter

Type

Description

internal

internal object

Internal network information.

external

external object

External network information.
Table 7 internal

Parameter

Type

Description

address

String

Internal IP address.

aport

String

Audio port.

atype

String

Audio type.

address_ipv6

String

IPv6 address.
Table 8 external

Parameter

Type

Description

address

String

External EIP.

aport

Integer

Audio port.

atype

Integer

Audio type.

address_ipv6

String

External IPv6 address.
Table 9 rtc

Parameter

Type

Description

ice_signaling

ice_signaling object

ICE signaling information.
Table 10 ice_signaling

Parameter

Type

Description

signaling_url

String

Signaling service access address.

expired_time

String

Streaming duration, in seconds.

ice_servers

Array of strings

ICE server.

Status code: 400

Table 11 Response body parameters

Parameter

Type

Description

error_code

String

0: successful.

KOOPHONE.API.1000: The request parameter is incorrect.

KOOPHONE.API.1001: Insufficient instance permissions.

KOOPHONE.API.9999: Internal service error.

error_msg

String

Error message.

Example Requests

POST API. The request URL carries the instance purchased by the tenant and the tenant token.

/v1/instances/Q39YyZvI/auth

Example Responses

Status code: 200

OK

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

Status code: 400

Bad Request

{
  "error_code" : "string",
  "error_msg" : "string"
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

Error Codes

See Error Codes.

Parent topic: Instance Management