# 激活 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" } } } ```