API 文档 · BaoBao 身份库

鉴权

操作	请求头	说明
GET 拉取	X-Api-Key	config.php 中配置的 api_key
POST 上传	X-Upload-Token	用户账户页中的 Upload Token
POST 上传	X-Api-Key	雷达系统批量上报（可选）

GET — 拉取列表

GET https://kd.eftdma.top/api.php?since=2026-01-01T00:00:00Z&limit=500&offset=0&category=cheater
X-Api-Key: YOUR_API_KEY

参数：since（ISO8601 增量）、limit（默认 500）、offset、category（default/cheater/streamer/radar）、profilesOnly=1

GET — 查询单条

GET https://kd.eftdma.top/api.php?profileId=5f2a4a0afe84191d5218caca
X-Api-Key: YOUR_API_KEY

POST — 批量上报

POST https://kd.eftdma.top/api.phpContent-Type: application/json
X-Upload-Token: YOUR_UPLOAD_TOKEN

{
  "entries": [
    {
      "profileId": "5f2a4a0afe84191d5218caca",
      "accountId": "6658150",
      "nickname": "PlayerName",
      "category": "radar"
    }
  ]
}

返回每条记录状态：inserted / updated / conflict / invalid。category 可选：default, cheater, streamer, radar。雷达后缀 displaySuffix 仅能通过网页管理员设置，API 上报时会忽略该字段。

POST — 预添加（仅 AccountId）

POST https://kd.eftdma.top/api.phpContent-Type: application/json
X-Upload-Token: YOUR_UPLOAD_TOKEN

{
  "entries": [
    {
      "accountId": "6658150",
      "accountOnly": true,
      "nickname": "PlayerName",
      "note": "twitch/xxx",
      "category": "streamer"
    }
  ]
}

accountOnly 为 true 或省略 profileId 时写入预添加表，匹配 ProfileId 后自动入库。

响应示例

{
  "entries": [
    {
      "profileId": "...",
      "accountId": "...",
      "nickname": "...",
      "category": "default",
      "updatedAt": "2026-06-10T12:00:00Z",
      "reportCount": 3
    }
  ],
  "count": 1,
  "serverTime": "2026-06-10T12:00:01Z"
}

分类说明

值	含义
default	普通玩家
cheater	作弊者
streamer	主播
radar	雷达用户