# 激活 License (/zh-CN/api-reference/api-ref/voip-callkit/activate-license)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

通过该接口实现 License 的激活。

- OpenAPI: /openapi/voip-callkit/call.zh-CN.yaml
- Operation ID: activateLicense
- Method: POST
- Path: /dabiz/license/v2/active
- Endpoint: https://api.sd-rtn.com/dabiz/license/v2/active

## Servers

- https://api.sd-rtn.com

## Authorization

This endpoint requires authentication.

- `Basic Auth`

## Parameters

- `pid` (query, required, string) - 由 SKU、有效期、品类定义的 License 激活标识。
- `licenseKey` (query, required, string) - 设备的唯一标识。例如设备的 SN 号、Mac 地址等。字符串长度需小于 64 字节。

> [!CAUTION]
> - 请注意区分大小写。
> - 请确保传入的 `licenseKey` 的值和发起呼叫接口中传入的 `wechat.deviceId` 一致。在调用发起呼叫接口时，SD-RTN™ 会对这两个值进行校验，如果一致且 License 在有效期，则呼叫成功，否则呼叫失败。

  - Max length: `64`
- `appid` (query, required, string) - 你的声网项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。

## Request body

No request body.

## Responses

### 200

请求成功。

- `data` (object)
  - `data.pid` (string) - 由 SKU、有效期、品类定义的 License 激活标识。
    - Example: `E4D6xxxxxxxxxxxxxxxxxxxxxxxx7E79`
  - `data.license` (string) - 激活的 License 的值。

你需要自行保存该值，以便后续进行续期等操作。

    - Example: `1D65xxxxxxxxxxxxxxxxxxxxxxxx6016`
  - `data.licenseKey` (string) - 设备的唯一标识。和你在 `active` 接口中传入的 `licenseKey` 一致。
    - Example: `1234xxxxxxxxxxx1234`
  - `data.expireTime` (integer) - License 的过期时间。
    - Example: `17xxxxxxxx`
    - Format: `int64`
  - `data.activationTime` (integer) - License 的激活时间。
    - Example: `17xxxxxxxx`
    - Format: `int64`
  - `data.skuView` (object) - SKU 能力集。

    - `data.skuView.product` (integer) - 产品类型:
- `1`: RTC
- `2`: RTSA
- `3`: FPA

      - Example: `1`
    - `data.skuView.name` (string) - SKU 的名称。
      - Example: `演示申请01`
    - `data.skuView.mediaType` (integer) - 媒体类型:
- `1`: 音频
- `2`: 视频
- `3`: 音视频

      - Example: `1`
    - `data.skuView.minutes` (integer) - License 分钟数上限。
      - Example: `100`
    - `data.skuView.period` (string) - License 使用时间段。
      - Example: `00:00~23:59`
### 非 200

请求失败。你可以根据返回的响应状态码和响应 Body 中 `message` 字段的描述排查错误。

- `message` (string) - 请求失败的错误信息。请结合返回的响应状态码排查错误。

## Response examples

### 200

```json
{
  "code": 200,
  "data": {
    "pid": "E4D6xxxxxxxxxxxxxxxxxxxxxxxx7E79",
    "license": "1D65xxxxxxxxxxxxxxxxxxxxxxxx6016",
    "licenseKey": "1234xxxxxxxxxxx1234",
    "expireTime": "17xxxxxxxx",
    "activationTime": "17xxxxxxxx",
    "skuView": {
      "product": 1,
      "name": "演示申请01",
      "mediaType": 1,
      "minutes": 100,
      "period": "00:00~23:59"
    }
  }
}
```