Lichess API：鉴权与接口规范索引

Lichess 官方 OpenAPI 主规范明确 HTTPS 主机、个人访问凭据及 PKCE OAuth，并给出账户读取 curl 示例。各 endpoint 的详细 schema 多在外部 $ref；本附件未展开，保持未知。限流要求逐个请求；仅文档整理，未登录或对弈。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：国际象棋／Lichess API 鉴权与账户读取规范 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 47e525c545a1a176d80ab928cd93179dd5c6288a51b754e098be595936e952ec

这份主规范索引覆盖账户、棋局、谜题、对局流、赛事等 API。为避免从路径名补写不存在的契约，本卡采用正文中明确展示的 /api/account 读取例子；用户、谜题等路径虽已列出，但它们的详细参数、认证范围和返回字段依赖本次未捕获的引用文件。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-071e190923924ce31c834c08 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-071e190923924ce31c834c08
名片版本: 2
资料更新: 2026-10-24T17:58:06.1051995+00:00
原作者 / 提供者: Lichess.org
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

账户读取例子明确 /api/account 与 Bearer 访问凭据；未给出其它查询参数。
主规范列出 /api/user/{username}、/api/puzzle/daily、/game/export/{gameId} 等路径，但详细方法与参数通过外部 $ref 引入，本卡不推断。

输出

账户读取响应的完整 schema 位于未展开的 ./tags/account/api-account.yaml，本附件没有可核对的字段样例。
规范概述说明某些 endpoint 以 NDJSON 流逐行返回 JSON；不将该行为推广到 /api/account。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。正文的 /api/account curl 示例使用个人访问凭据的 Bearer header；规范还支持授权码加 PKCE 的 OAuth 路径。本次未生成、取得或使用凭据。

运行前提

账户读取示例需要个人访问凭据；其确切 scope 与响应字段位于未展开的 endpoint 引用。
OAuth 路径支持 PKCE S256，不支持 refresh tokens；是否采用 OAuth 依实际应用需求。
按文档每次只发一个请求；遇429应降低频率，通常等待一分钟但有些限制更久。

公开请求示例

{
  "documentation_text": "curl \u793A\u4F8B\u4EE5 Bearer \u4E2A\u4EBA\u8BBF\u95EE\u51ED\u636E\u8BFB\u53D6\u8D26\u6237\uFF1B\u672C\u5361\u7701\u7565\u51ED\u636E\u4E14\u672A\u6267\u884C\u3002",
  "method": "GET",
  "url": "https://lichess.org/api/account"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。规范称 Lichess 是 free/libre、开源并依赖志愿者与捐赠的棋类服务器，但未在本附件单列 API 调用价格/额度契约；保持未知。

价格来源 · 未知

资料去向

提供者服务器。认证请求由 Lichess 服务端处理，可关联账户。主规范强调凭据保密，但未说明请求日志与账户数据保留；本次未读取真实账户。

限制

所有请求均采用多种限流策略，必须逐个请求；未公布统一固定每秒配额。
主规范大部分 path 和 schema 使用相对 $ref；引用文件未包含在本附件，不足以形成完整单端点契约。
默认主机为 https://lichess.org；Opening Explorer、Tablebase 等另有明确主机，不能混用。
账号凭据可在 scope 范围内触发账户操作；本次只整理读取样例，不登录、授权、下棋或发送消息。

仍需核对

/api/account 所需 scope、完整输入与响应 schema 依赖未捕获的 $ref。
数值配额、API 费用条款、SLA、日志与数据保留未知。
具体公开数据端点是否免认证不能从此索引统一判定；当前可用性未测试。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T17:56:56.7629244+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

api/doc/specs/lichess-api.yaml at master · lichess-org/api · GitHub · 官方文档 · 2026-10-25T01:56:56.7629244+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://github.com/lichess-org/api/blob/master/doc/specs/lichess-api.yaml",
  "final_url": "https://github.com/lichess-org/api/blob/master/doc/specs/lichess-api.yaml",
  "status_code": 200,
  "title": "api/doc/specs/lichess-api.yaml at master \u00B7 lichess-org/api \u00B7 GitHub",
  "description": "Lichess API documentation. Contribute to lichess-org/api development by creating an account on GitHub.",
  "checked_at": "2026-10-24T17:56:56.7629244\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-071e190923924ce31c834c08",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://github.com/lichess-org/api/blob/master/doc/specs/lichess-api.yaml"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。