KARDS 军械库 API

基于 Node.js + Canvas 的 KARDS 卡组图片生成服务，由KARDS 军械库提供。

声明

本项目遵循1939 Games的 "Community content policy"(社区内容政策) ，使用1939 Games 拥有的资产。1939 Games 并未直接支持或赞助本项目。所有卡牌图像版权归 1939 Games 所有，本项目仅作非商业学习与工具用途。

/health 健康检查

https://karsenal-api.netlify.app/.netlify/functions/health

方法：GET

检查土豆是否成熟

响应格式

{
  "status": "ok",
  "timestamp": "2026-09-25T11:30:00.000Z",
  "uptime": 12.34
}

示例

curl https://karsenal-api.netlify.app/.netlify/functions/health

/generate 卡组图片生成

https://karsenal-api.netlify.app/.netlify/functions/generate

方法：POST

生成KARDS卡组图片

请求头

Content-Type: application/json

请求体

基础

参数	类型	默认值	描述
deckCode	string	-	必填，KARDS卡组代码
cols	number	10	每行卡牌数量
scale	number	50	缩放比例(25-100)
lang	string	zh-Hans	语言代码
bgColor	string	transparent	背景颜色(十六进制颜色码)

附件

参数	类型	默认值	描述
foldEnabled	boolean	false	折叠重复卡牌
addStatsCard	boolean	true	统计卡
statsTitle	string	卡组统计	统计卡标题
qrEnabled	boolean	false	二维码卡
qrTitle	string	卡组二维码	二维码卡标题
hq	string	-	总部cardId(如moscow)
statsChartToggle	boolean	false	额外统计图

高级

参数	类型	默认值	描述
version	string	DEFAULT_VERSION	卡牌版本
spacingX	number	0	水平间距
spacingY	number	0	垂直间距
emptySlots	array	[]	空位索引数组
cardOverrides	object	{}	单卡覆盖配置

cardOverrides 格式

{
  "cardId": {
    "version": "v52",
    "cost": 3,
    "star": true
  }
}

语言代码

代码	语言
zh-Hans	简体中文
zh-Hant	繁体中文
en-EN	English
fr-FR	Français
de-DE	Deutsch
pl-PL	Polski
pt-BR	Português
ru-RU	Pусский
it-IT	Italiano
es-ES	Español
ko-KR	한국어
ja-JP	日本語

响应格式

{
  "mainImage": "data:image/png;base64,...",
  "statsChart": "data:image/png;base64,..."
}

字段	描述
mainImage	卡组图片(Base64)
statsChart	额外统计图(仅当 statsChartToggle: true 时返回)

错误响应

{
  "error": "错误描述"
}

示例

cURL

curl -X POST https://karsenal-api.netlify.app/.netlify/functions/generate \
  -H "Content-Type: application/json" \
  -d '{
    "deckCode": "%%5a|jvpy;j3xAyc;czydj1bPmI;ggbKpEy6",
    "cols": 8,
    "lang": "zh-Hans"
  }'

JavaScript (Node.js)

import fs from 'fs';

const response = await fetch('https://karsenal-api.netlify.app/.netlify/functions/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    deckCode: '%%5a|jvpy;j3xAyc;czydj1bPmI;ggbKpEy6',
    cols: 8,
    lang: 'zh-Hans'
  })
});

const data = await response.json();
// 提取 Base64 数据
const base64Data = data.mainImage.replace(/^data:image\/png;base64,/, '');
fs.writeFileSync('deck.png', Buffer.from(base64Data, 'base64'));

Python

import requests
import base64

response = requests.post('https://karsenal-api.netlify.app/.netlify/functions/generate', json={
    'deckCode': '%%5a|jvpy;j3xAyc;czydj1bPmI;ggbKpEy6',
    'cols': 8,
    'lang': 'zh-Hans'
})

data = response.json()
base64_data = data['mainImage'].split(',')[1]
with open('deck.png', 'wb') as f:
    f.write(base64.b64decode(base64_data))

/deck-json 卡组JSON

https://karsenal-api.netlify.app/.netlify/functions/deck-json

方法：GET/POST

解析卡组并返回格式化卡牌数据

请求头

Content-Type: application/json

请求体

参数	类型	默认值	描述
deckCode	string	-	KARDS卡组代码

示例

curl -X POST https://karsenal-api.netlify.app/.netlify/functions/deck-json \
  -H "Content-Type: application/json" \
  -d '{"deckCode":"%%5a|jvpy;j3xAyc;czydj1bPmI;ggbKpEy6"}'

响应格式

{
  "mainFaction": "usa",
  "allyFaction": "anzac",
  "mainFactionName": "美国",
  "allyFactionName": "澳新军团",
  "totalCards": 39,
  "uniqueCards": 14,
  "cards": [
    {
      "count": 4,
      "card": {
        "id": 93750,
        "cardId": "the_war_machine",
        "importId": "bK",
        "titleZh": "战争机器",
        "titleEn": "THE WAR MACHINE",
        "text_zh": "额外获得 1 个指挥点槽。",
        "textMap": {
          "zh-Hans": "额外获得 1 个指挥点槽。",
          "zh-Hant": "額外獲得 1 個指揮點槽。",
          …
        },
        "titleMap": {
          "zh-Hans": "战争机器",
          "zh-Hant": "戰爭機器",
          …
        },
        "faction": "usa",
        "type": "order",
        "rarity": "Standard",
        "cost": 2,
        "attributes": [],
        "setName": "Base",
        "image": "the_war_machine.avif",
        "reserved": false,
        "isSpawn": false,
        "isVeteranSet": false,
        "canCreate": []
      }
    },
    …
  ]
}

示例

const res = await fetch('https://karsenal-api.netlify.app/.netlify/functions/deck-json', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ deckCode: '%%5a|jvpy;j3xAyc;czydj1bPmI;ggbKpEy6' })
});
const data = await res.json();
data.cards.forEach(({ count, card }) => {
  console.log(`${card.titleZh} ×${count}  (${card.cost}K)`);
});

许可

MIT