扣减指定功能权益额度

POST

/api/v1/sdk/licenses/consume

使用 SDK Bearer，amount 为正整数。feature_code 必须匹配 entitlements；旧版无功能行的授权使用 default。服务端在事务内同时校验功能及总额度；409 时整次扣减回滚。支持任何配置了额度的套餐。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "app_key": "video-tool-test-example",
    "amount": 1,
    "feature_code": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/sdk/licenses/consume' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "app_key": "video-tool-test-example",
    "amount": 1,
    "feature_code": "default"
}'

返回响应

🟢200

application/json

操作成功。

Bodyapplication/json

示例

{
    "success": true,
    "consumed": 1,
    "quota_total": 100,
    "quota_used": 1,
    "remaining": 99,
    "exhausted": false
}

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴503

修改于 2026-10-12 09:15:56

校验当前设备的授权与权益

调用文本对话