1. SDK 授权登录
器灵 AI 开发者接入 API
  • 账号与开发者身份
    • 查询当前账号身份
      GET
    • 创建微信扫码登录会话
      POST
    • 查询微信扫码登录状态
      GET
    • 创建 GitHub 开发者绑定会话
      POST
    • 查询开发者资料和审核状态
      GET
    • 刷新平台账号会话
      POST
    • 退出平台账号会话
      POST
  • 子应用与套餐查询
    • 初始化子应用品牌和套餐
      GET
    • 查询站点软件与套餐
      GET
    • 生成分站推广归属凭据
      POST
  • 软件续费与支付
    • 创建软件续费或升级支付二维码
      POST
    • 查询当前用户的支付订单状态
      GET
  • 开发者软件管理
    • 列出自己的软件
      GET
    • 创建软件草稿
      POST
    • 查看自己的软件详情
      GET
    • 保存软件与套餐修改
      PUT
    • 提交软件上架审核
      POST
    • 撤回待审核软件或套餐修改
      POST
    • 上传软件封面图片
      POST
    • 上传软件轮播图片
      POST
  • 开发者订单与收入
    • 查看开发者工作台统计
      GET
    • 查看自有软件订单
      GET
    • 查看订单收入与月度结算日期
      GET
  • 开发者提现
    • 查看提现账户与申请记录
    • 提交开发者提现申请
    • 保存开发者收款账户
    • 上传私有收款二维码
  • SDK 授权登录
    • 授权码登录并绑定设备
      POST
    • 校验当前设备的授权与权益
      POST
  • SDK 额度扣减
    • 扣减指定功能权益额度
  • SDK AI 能力
    • 调用文本对话
    • 调用文本翻译
    • 调用图像生成
  • SDK 会话管理
    • 刷新 SDK 授权会话
    • 退出 SDK 授权会话
  • 上架前开发调试
    • 列出软件测试授权
    • 生成或重置草稿套餐测试授权
    • 停用软件测试授权
  • 设备绑定与授权校验
    • 激活授权设备
    • 验证设备授权
    • 解除设备绑定
  • 数据模型
    • AccountProfileReply
    • AccountSessionReply
    • AiChatMessage
    • AiChatReply
    • AiChatRequest
    • AiImageReply
    • AiImageRequest
    • AiQuotaReply
    • AiTranslateReply
    • AiTranslateRequest
    • ApiError
    • AttributionReply
    • AttributionRequest
    • Body_upload_developer_product_image_api_v1_developer_uploads_product_carousel_post
    • Body_upload_developer_product_image_api_v1_developer_uploads_product_image_post
    • Body_upload_developer_withdrawal_qr_api_v1_developer_uploads_withdrawal_qr_post
    • BootstrapReply
    • ChatDataReply
    • ChatUsageReply
    • DeveloperDeliveryPayload
    • DeveloperIdentityReply
    • DeveloperOrderList
    • DeveloperOrderReply
    • DeveloperPlanPayload
    • DeveloperProductList
    • DeveloperProductPayload
    • DeveloperProductReply
    • DeveloperProfileReply
    • DeveloperTestLicensePayload
    • DeviceActivateRequest
    • EarningReply
    • DeviceLicenseReply
    • EarningsReply
    • EarningsSummaryReply
    • GithubBindingReply
    • ImageDataReply
    • LicenseVerifyRequest
    • MediaCorePaymentCreate
    • OverviewReply
    • PaymentCreateReply
    • PaymentStatusReply
    • QuotaReply
    • RefreshSessionRequest
    • SdkAppReply
    • SdkCurrentDevice
    • SdkDeviceReply
    • SdkEntitlementReply
    • SdkLicenseCheckRequest
    • SdkLicenseLoginRequest
    • SdkLicenseReply
    • SdkPlanReply
    • SdkProductReply
    • SdkQuotaConsumeRequest
    • SdkRefreshReply
    • SdkSessionReply
    • SdkSessionUser
    • SdkSiteReply
    • SdkStorefrontReply
    • SdkSupportReply
    • SessionUser
    • SuccessReply
    • TestLicenseList
    • TestLicenseReply
    • TranslateDataReply
    • UploadReply
    • WechatLoginSessionRequest
    • WechatSessionReply
    • WechatStatusReply
    • WithdrawalAccountPayload
    • WithdrawalAccountReply
    • WithdrawalReply
    • WithdrawalRequestPayload
    • WithdrawalsReply
  1. SDK 授权登录

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

POST
/api/v1/sdk/license/check
Authorization: Bearer sdk_token;app_key 与 device_id 必须与登录会话一致。校验不会重新签发凭证。先检查 valid,再逐项检查 entitlements 的 valid/reason;null 到期时间不能直接判定永久。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "app_key": "video-tool-test-example",
    "device_id": "example-device-001",
    "client_version": "1.0.0"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v1/sdk/license/check' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "app_key": "video-tool-test-example",
    "device_id": "example-device-001",
    "client_version": "1.0.0"
}'

返回响应

🟢200
application/json
操作成功。
Bodyapplication/json

示例
{
    "app": {
        "app_key": "video-tool-test-example",
        "app_name": "视频压缩工具",
        "app_type": "desktop",
        "site_name": "示例品牌",
        "logo_url": "",
        "primary_color": "#12a36d",
        "download_url": "https://example.com/download",
        "delivery_url": "https://example.com/download",
        "delivery_label": "立即下载",
        "support": {
            "name": "示例客服",
            "wechat": "",
            "qr_url": "",
            "url": ""
        }
    },
    "site": {
        "code": "platform",
        "brand_name": "示例品牌",
        "host": "ql.xiazq.com"
    },
    "product": {
        "slug": "video-compressor",
        "name": "视频压缩工具",
        "category": "视频处理",
        "description": "批量压缩视频",
        "app_key": "video-tool-test-example",
        "plans": [
            {
                "code": "monthly",
                "name": "月卡",
                "kind": "duration",
                "price": 0,
                "duration_days": 30,
                "quota": 100,
                "quota_mode": "reset",
                "quota_unit": "次",
                "feature_code": "default",
                "feature_name": "基础功能",
                "device_limit_type": "limited",
                "device_limit": 2,
                "account_limit_type": "unlimited",
                "account_limit": 0,
                "ai_enabled": true
            }
        ],
        "currency": "CNY",
        "default_plan_code": "monthly",
        "purchase_enabled": false,
        "renew_enabled": false,
        "testing": true
    },
    "valid": true,
    "testing": true,
    "license": {
        "id": 123,
        "license_key": "QLTEST-EXAMPLE-ONLY-DO-NOT-USE",
        "product_slug": "video-compressor",
        "plan_code": "monthly",
        "expires_at": "2026-11-11T22:22:53+08:00",
        "pending_activation": false,
        "is_activated": true,
        "is_perpetual": false,
        "is_free": false,
        "device_limit_type": "limited",
        "device_limit": 2,
        "account_limit_type": "unlimited",
        "account_limit": 0,
        "quota_total": 100,
        "quota_used": 0
    },
    "user": {
        "name": "示例用户",
        "username": "example-user"
    },
    "device": {
        "device_id": "example-device-001"
    },
    "devices": [
        {
            "device_id": "example-device-001",
            "device_name": "开发电脑",
            "platform": "linux",
            "client_version": "1.0.0",
            "last_seen": "2026-10-12T22:22:53+08:00",
            "created_at": "2026-10-12T22:22:53+08:00",
            "status": "active"
        }
    ],
    "entitlements": [
        {
            "feature_code": "default",
            "feature_name": "基础功能",
            "product": "视频压缩工具",
            "product_slug": "video-compressor",
            "app_key": "video-tool-test-example",
            "plan_code": "monthly",
            "plan_name": "月卡",
            "kind": "duration",
            "valid": true,
            "reason": "",
            "expires_at": "2026-11-11T22:22:53+08:00",
            "quota_total": 100,
            "quota_used": 0,
            "is_activated": true,
            "pending_activation": false,
            "is_perpetual": false
        }
    ]
}
🟠400
🟠401
🟠403
🟠404
🟠409
🟠422
🔴503
修改于 2026-10-12 09:15:56
上一页
授权码登录并绑定设备
下一页
扣减指定功能权益额度
Built with