KARDS Decker API卡牌、卡组与备卡的公开接口

从一条可运行的请求开始，再按需深入字段与校验规则。

先解决备卡

创建、更新和读取 `guide.reserve_recommendations` 的完整请求示例。

端点、字段、权限和错误格式与 `/api/v1` 的实际实现及契约测试保持一致。

图鉴和公开卡组无需密钥；个人卡组使用 `kd_` API Key，密钥只放请求头。

text

https://1939.giaory.xyz/api/v1

所有成功响应都使用 { data, meta }，所有失败响应都使用 { error }。

密钥安全

API Key 只能放在 Authorization: Bearer ... 请求头中。不要把密钥写进 URL、仓库、日志、截图或前端代码。