Check quota availability

POST

/v1/billing/quota-checks

Validates whether a session is allowed to continue based on the current entitlement snapshot.

请求参数

Body 参数application/json必填

示例

{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "userID": "local-user-001",
    "mode": "voiceInput"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/billing/quota-checks' \
--header 'Content-Type: application/json' \
--data '{
    "sessionID": "11111111-1111-1111-1111-111111111111",
    "userID": "local-user-001",
    "mode": "voiceInput"
}'

返回响应

🟢200成功

application/json

Quota check completed.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/billing/quota-checks",
    "result": {
        "sessionID": "11111111-1111-1111-1111-111111111111",
        "userID": "local-user-001",
        "mode": "voiceInput",
        "allowed": true,
        "reason": null,
        "entitlementSnapshot": {
            "userID": "local-user-001",
            "plan": "pro",
            "allowedModes": [
                "voiceInput",
                "translation",
                "rewrite"
            ],
            "remainingQuotaSeconds": 7200,
            "remainingAddonSeconds": 600,
            "asOf": "2026-04-01T16:20:00Z",
            "totalRemainingSeconds": 7800
        },
        "checkedAt": "2026-04-01T16:20:00Z"
    }
}

修改于 2026-08-26 04:04:36

Read an entitlement snapshot

Consume quota