游戏库接口

Dracalon 游戏库对外开放接口的字段、业务规则、示例与错误（当前：推荐游戏 POST /v1/game/recommend）。

约 6 分钟 2026-07-02 更新

游戏库对外开放的接口都汇总在这里。鉴权、签名、统一响应信封与鉴权层错误码见开发者文档；本页只列各端点的字段与业务规则。更多游戏库接口将陆续开放，届时在本页新增小节，无需另找文档。

所有接口挂在子域 https://openapi.dracalon.com，路径形如 /v1/...，Content-Type: application/json。签名头（X-Access-Key / X-Timestamp / X-Nonce / X-Signature 等）与 canonical 串规则见开发者文档 · 鉴权与签名。

推荐游戏 · `POST /v1/game/recommend`

代凭证绑定会员提交一条游戏推荐，与该会员在网页提交推荐完全等价——同一套后台审核流程、通知与统计，调用方无法冒用其他会员身份。需要凭证被授权 game.recommend 接口，且绑定会员必须已绑定有效邮箱。

业务规则

归属凭证绑定会员：推荐记录挂在该 AccessKey 绑定的会员名下。多个凭证绑定同一会员则共享下列配额。
每日配额：按绑定会员计，每天最多 5 条（含待审 / 通过 / 驳回，撤回不占额）。超出返回 今日推荐次数已达上限，请明天再来。
先提交后审核：成功只代表进入待审核（status=0），是否上架由运营审核决定，结果通过站内信 + 邮件通知绑定会员。
功能开关：若后台关闭了游戏推荐，返回 游戏推荐功能暂未开放。

请求字段

字段	类型	必填	说明
`game_name`	string	是	游戏名称，1–120 字符
`intro`	string	是	推荐说明，去 HTML 后 10–5000 字符
`platforms`	string[]	是	至少 1 个发行平台，取值见下
`external_links`	object[]	是	至少含 1 条「获取途径」链接，元素 `{type, url}`，最多 6；type 见下
`authorization_type`	int	是	`1`官方代表 `2`已获授权 `3`未获授权（开放推荐）
`authorization_confirmed`	int	是	必须为 `1`（勾选授权承诺），否则拒收
`cover`	string	否	封面：`http(s)` 绝对 URL 或 `/` 开头相对路径，≤500
`developer`	string	否	开发商，≤120
`publisher`	string	否	发行商，≤120
`release_date_text`	string	否	发售日自由文本，≤40
`genre_ids`	int[]	否	游戏类型 ID，最多 5，须为站内已启用类型
`tag_ids`	int[]	否	标签 ID，最多 20，须为站内已启用标签
`screenshots`	object[]	否	截图 `{url, name?, size?}`，最多 8

`platforms` 取值

windows macos linux ios android switch ps5 ps4 xbox web tabletop

`external_links[].type` 取值

获取途径（至少需 1 条此类）：steam itch epic gog xbox playstation nintendo patreon netdisk official
相关链接（社交）：bilibili youtube twitter discord reddit weibo pixiv instagram other

请求示例

{
  "game_name": "测试游戏",
  "intro": "至少十个字符的游戏推荐说明内容。",
  "platforms": ["windows", "switch"],
  "external_links": [
    { "type": "steam",    "url": "https://store.steampowered.com/app/123456" },
    { "type": "bilibili", "url": "https://www.bilibili.com/video/BVxxxx" }
  ],
  "developer": "某工作室",
  "release_date_text": "2025-12",
  "authorization_type": 3,
  "authorization_confirmed": 1
}

成功响应

{
  "code": 1,
  "msg": "Submit success",
  "time": 1719200000,
  "data": { "id": "880201", "status": 0, "create_time": 1719200000, "request_id": "..." }
}

status=0 表示待审核（PENDING）。任意响应都带 X-Request-Id 响应头，与 data.request_id 一致，便于排障。

常见业务错误（`code=0`）

msg	触发
`游戏名称不能为空` / `推荐说明长度必须在 10-5000 个字符之间` 等	字段校验未过
`请选择授权类型` / `请勾选授权承诺`	`authorization_type` 不在 1/2/3 或 `authorization_confirmed≠1`
`请先在账户中绑定有效邮箱后再推荐`	绑定会员无有效邮箱
`请至少选择一个发行平台` / `不支持的平台：xxx`	platforms 为空或含非法值
`请至少填写一条「获取途径」链接（Steam / itch.io / 官网等）`	external_links 无获取途径类型
`今日推荐次数已达上限，请明天再来`	超每日配额
`部分类型不存在或已禁用` / `部分标签不存在或已禁用`	genre_ids / tag_ids 非法

推荐游戏 · POST /v1/game/recommend