接口文档

只读开放接口，可用于插件端校验、站点自检或第三方查询

通用说明

接口地址https://auth.bvcoms.cn/api/query.php
请求方式POST / GET（form-urlencoded 或 query string）
返回格式JSON（UTF-8）
单条限流每 IP 每分钟 5 次
批量限流每 IP 每分钟 3 次，每次最多 20 个域名
跨域仅放行 www.bvcoms.cn / auth.bvcoms.cn
限流响应HTTP 429 + Retry-After 头，body 内含 cooldown 秒数
失败响应HTTP 400（参数）/ 405（方法）/ 503（数据源）

单条授权校验

参数必填说明
action是固定为 query
product_id是产品 ID，见产品中心
domain是授权域名，不带协议与路径，大小写不敏感

请求示例

curl -X POST https://auth.bvcoms.cn/api/query.php \
  -d "action=query" \
  -d "product_id=24" \
  -d "domain=www.example.com"

返回示例（校验通过）

{
  "error": 0,
  "message": "校验通过：该域名持有有效正版授权",
  "data": {
    "username": "A***V",
    "product_name": "博文美化插件",
    "domain": "www.example.com",
    "is_valid": true,
    "status": "正常",
    "expire_time": "永久有效",
    "create_time": "2026-10-14",
    "last_comm": "2026-10-23",
    "related": []
  }
}

返回示例（无授权）

{
  "error": 1,
  "message": "您查询的 xxxx.com 未查询到授权记录，可能为非正版授权或域名填写有误",
  "data": null
}

在线试一试

按授权码查询

忘记绑定的域名时，用授权码反查授权详情（返回脱敏授权码）。

参数必填说明
action是固定为 key
auth_key是授权码，8–64 位字母数字（会自动转大写并去除符号）
product_id否不传则跨产品查找
 
curl -X POST https://auth.bvcoms.cn/api/query.php \
  -d "action=key" \
  -d "auth_key=6f3684076c7c7a1e7a51d94ab68af3e0"

返回结构与单条查询一致，额外含 data.auth_key（脱敏）。

批量授权校验

参数必填说明
action是固定为 batch
product_id是产品 ID
domains是多个域名，用逗号、分号或换行分隔，最多 20 个
 
curl -X POST https://auth.bvcoms.cn/api/query.php \
  -d "action=batch" \
  -d "product_id=24" \
  -d "domains=a.com,b.com,c.com"

返回 data.items[] 数组，每项含 domain / is_valid / status / expire_time / last_comm / username。

健康检查

curl -s https://auth.bvcoms.cn/api/health.php

返回 status / db / products / auths / time，可用于监控探活（异常时 HTTP 503）。

错误码

HTTPerror含义处理建议
2000成功按 data 字段渲染
2001查询成功但无授权（正常业务结果）提示「未授权」，不要当作接口故障重试
4001参数错误：缺产品 / 域名非法 / 超过 20 个域名按 message 修正入参后重试
4051请求方式不支持改用 GET / POST
4291触发限流按 Retry-After 或 cooldown 秒数退避重试
5031授权数据源暂时不可用指数退避重试，勿高频轮询
示例（curl）： 
curl -X POST https://auth.bvcoms.cn/api/query.php \
  -d 'action=query' -d 'product_id=24' -d 'domain=www.example.com'