-
标记名字数
-
总标记次数

玩家标记查询

输入玩家名/ID/任意标记对象,查询其被标记次数、称号与分类内排名。支持一次查询多个(用逗号或空格分隔)。

全服排行 TOP 50

排名玩家名标记次数称号最近标记
加载中...

API 文档

共享标记数据库 API 服务,供外挂/辅助作者集成标记与查询功能。数据按分类(游戏/场景)完全隔离,一个 API Key 绑定一个分类,标记自动归入该分类,各分类排行互不干扰。

0. 自助申请 API Key(作者入口)

POST /api/v1/key/apply

请求体 {"label":"作者标识","category":"分类名"}。分类不存在会自动创建,返回一次性明文 Key。限速:每 IP 每小时 10 次。

1. 玩家查询(开放)

GET /api/v1/lookup?category=分类名&name=玩家名

查询单个对象:返回标记次数、称号、首次/最近标记时间、今日及近7天新增、分类内排名与分类统计。

POST /api/v1/lookup

批量查询(单次最多 500 个):请求体 {"category":"分类名","names":["张三","李四"]}{"category":"分类名","name":"张三"}

2. 提交标记(需 API Key)

POST /api/v1/mark

请求头携带 X-API-Key: 你的Key。请求体 {"names":["张三","李四"]}(≤500)或 {"name":"张三"}

标记对象由作者自由决定:可以是玩家名、UID、段位、积分、角色ID等任意字符串,自动归入该 Key 绑定的分类。返回每个对象的最新标记总数与称号。限速:每 Key 120 次/分,每 IP 60 次/分。

3. 全服排行(开放)

GET /api/v1/rank?category=分类名&top=50

返回该分类内被标记次数最多的前 N 名(默认 50,上限 200)。

4. 分类列表(开放)

GET /api/v1/categories

返回全部分类及各自的名字数/标记次数统计。

5. 健康检查(开放)

GET /api/v1/health

返回服务状态、总名字数、总标记次数、分类数、称号档位数。

响应格式

所有接口统一返回 JSON:

{"code":0,"msg":"ok","data":{...}}

code=0 表示成功;非 0 时 msg 为错误说明。