端点总表

基础地址：https://1939.giaory.xyz/api/v1

无需鉴权

方法	路径	说明
GET	/	API 版本与发现信息
GET	/cards	搜索卡牌目录
GET	/cards/:card_id	按 ID 读取卡牌
GET	/card-backs	搜索卡背目录
GET	/decks	搜索公开卡组
GET	/decks/:share_slug	按分享标识读取公开或未列出卡组

API Key 鉴权

方法	路径	Scope	成功状态
GET	/users/:user_id/decks	decks:read	200
POST	/users/:user_id/decks	decks:write	201
GET	/users/:user_id/decks/:deck_id	decks:read	200
PATCH	/users/:user_id/decks/:deck_id	decks:write	200
DELETE	/users/:user_id/decks/:deck_id	decks:delete	200
POST	/users/:user_id/decks/validate	decks:write	200
POST	/users/:user_id/decks/replace	decks:write	200

路径参数

参数	格式	说明
user_id	UUID	API Key 所属账号的军籍编号
deck_id	UUID	自己的卡组 ID
share_slug	1–64 位字母、数字、_ 或 -	对外分享标识
card_id	字符串	卡牌目录返回的稳定 ID

完整的机器可读契约见 OpenAPI 3.1。