KARDS Decker API

主题

读取公开卡组 ​

公开卡组接口无需 API Key。列表只包含 visibility: public 的卡组；知道分享标识时，详情接口也能读取 unlisted 卡组。

搜索公开卡组 ​

GET /api/v1/decks

bash
curl "https://1939.giaory.xyz/api/v1/decks?main_faction=Germany&tag=天梯&sort=likes&limit=20"
参数说明
q按卡组名称搜索
main_faction主阵营
ally_faction盟军阵营
tag必须包含的精确标签
sortdate、views 或 likes；默认 date
page / limit页码和每页数量；limit 最大 50

读取单个卡组 ​

GET /api/v1/decks/:share_slug

bash
curl "https://1939.giaory.xyz/api/v1/decks/<share_slug>"

share_slug 来自列表响应，不是卡组 UUID。找不到公开或未列出的分享卡组时返回 404 deck_not_found。

响应中的常用区域：

json
{
  "data": {
    "id": "<deck_id>",
    "name": "<卡组名称>",
    "deck_code": "%%...",
    "cards_snapshot": [
      { "card_id": "<card_id>", "count": 2 }
    ],
    "tags": ["天梯"],
    "display": {
      "featured_card_id": "<card_id>",
      "card_back_id": "<card_back_id>"
    },
    "guide": {
      "system": "装甲控制",
      "reserve_recommendations": ["<card_id>"]
    },
    "author": {
      "display_name": "<显示名称>"
    }
  },
  "meta": { "api_version": "v1" }
}

公开响应不包含 visibility 和 sort_order 等仅限所有者的管理字段。