POST /api/private/v1/entitlements

批量校验任意客户当前是否具备一个或多个功能授权。

鉴权

Authorization: Bearer <PRIVATE_API_KEY>
Content-Type: application/json

请求体

{
  "customer": "customer_001",
  "features": [
    { "feature": "chat", "required": 0 },
    { "feature": "image-generate", "required": 2 }
  ]
}

字段	类型	必填	说明
customer	string	是	客户用户名
features[].feature	string	是	功能标识（slug）
features[].required	number	否	所需剩余额度，默认 0

成功响应

data.entitlements 中每一项都表示一个功能当前的授权快照：

{
  "ok": true,
  "requestId": "req_123",
  "data": {
    "customer": "customer_001",
    "entitlements": [
      {
        "customer": { "id": 1, "username": "customer_001" },
        "feature": {
          "id": 2,
          "slug": "image-generate",
          "name": "Image Generate",
          "metered": true,
          "unit": "count"
        },
        "allowed": true,
        "metered": true,
        "unlimited": false,
        "totalUsed": 3,
        "totalLimit": 10,
        "available": 7,
        "subscriptions": [
          {
            "subscriptionId": 10,
            "planId": 2,
            "planName": "Pro",
            "priority": 0,
            "limit": 10,
            "used": 3,
            "remaining": 7,
            "resetInterval": "P1M",
            "periodStart": "2026-03-01T00:00:00.000Z",
            "periodEnd": "2026-04-01T00:00:00.000Z",
            "validFrom": "2026-03-01T00:00:00.000Z",
            "validTo": "2026-04-01T00:00:00.000Z"
          }
        ]
      }
    ]
  }
}

可能错误

• 404 CUSTOMER_NOT_FOUND
• 404 FEATURE_NOT_FOUND
• 404 NO_ACTIVE_ENTITLEMENT
• 409 INSUFFICIENT_QUOTA
• 400 FEATURE_NOT_METERED