输入玩家名/ID/任意标记对象,查询其被标记次数、称号与分类内排名。支持一次查询多个(用逗号或空格分隔)。
| 排名 | 玩家名 | 标记次数 | 称号 | 最近标记 |
|---|---|---|---|---|
| 加载中... | ||||
共享标记数据库 API 服务,供外挂/辅助作者集成标记与查询功能。数据按分类(游戏/场景)完全隔离,一个 API Key 绑定一个分类,标记自动归入该分类,各分类排行互不干扰。
POST /api/v1/key/apply
请求体 {"label":"作者标识","category":"分类名"}。分类不存在会自动创建,返回一次性明文 Key。限速:每 IP 每小时 10 次。
GET /api/v1/lookup?category=分类名&name=玩家名
查询单个对象:返回标记次数、称号、首次/最近标记时间、今日及近7天新增、分类内排名与分类统计。
POST /api/v1/lookup
批量查询(单次最多 500 个):请求体 {"category":"分类名","names":["张三","李四"]} 或 {"category":"分类名","name":"张三"}。
POST /api/v1/mark
请求头携带 X-API-Key: 你的Key。请求体 {"names":["张三","李四"]}(≤500)或 {"name":"张三"}。
标记对象由作者自由决定:可以是玩家名、UID、段位、积分、角色ID等任意字符串,自动归入该 Key 绑定的分类。返回每个对象的最新标记总数与称号。限速:每 Key 120 次/分,每 IP 60 次/分。
GET /api/v1/rank?category=分类名&top=50
返回该分类内被标记次数最多的前 N 名(默认 50,上限 200)。
GET /api/v1/categories
返回全部分类及各自的名字数/标记次数统计。
GET /api/v1/health
返回服务状态、总名字数、总标记次数、分类数、称号档位数。
所有接口统一返回 JSON:
{"code":0,"msg":"ok","data":{...}}
code=0 表示成功;非 0 时 msg 为错误说明。