跳到主要内容

统一卡牌资料,
连接每一次数据查询。

按名称、系列、编号、语言与版本组织卡牌资料,用一致的卡牌记录连接搜索、商品展示、库存与收藏。

检索输入
query,按名称或系列搜索
目录输出
items 卡牌记录与 total 匹配数量
业务关联
卡牌 ID 与你的商品或收藏记录
Query → Card record03 records返回结果
Card record

Charizard ex

SV03: Obsidian Flames

卡牌编号
223/197
印刷语言
English
卡牌版本
Holofoil
稀有度
Special Illustration Rare
tcgplayer:509980
卡牌系列卡牌版本
3 条记录

把卡牌资料,组织成可复用的数据。

既能找到目标卡牌,也能分清同名、不同系列与不同版本。

找到卡牌,确认身份。

从名称搜索走向完整的资料记录。

基础卡牌资料

以卡牌记录组织名称、所属品类、系列与卡号,为搜索结果、详情页和录入界面提供一致的信息。

卡牌记录关联

通过卡牌 ID 对应目录中的记录,让识别结果、商品资料和收藏档案引用同一份卡牌数据。

相似卡面,保留差异。

重要的发行维度不藏在名称里。

系列与编号

把系列与卡号作为独立维度展示。同名卡牌出现在不同系列时,可结合这些字段进行核对与选择。

语言与版本

分别组织卡牌语言、闪卡等版本信息,帮助业务端呈现差异,避免把不同发行记录合并成同一条。

一份目录,多处使用。

让卡牌资料成为业务间的共同基础。

搜索与详情展示

将返回的卡牌资料用于搜索结果、筛选项与详情信息。根据业务需要选择展示字段,减少各个页面重复维护。

关联更多数据

从已确认的卡牌记录继续组织价格或 Pop 查询。保留版本与语言条件,让后续信息与目标卡牌对应。

让目录数据与业务数据,各自清晰。

一张标准卡牌,可以被多个商品、库存与收藏记录引用。

目录中的卡牌

保存卡牌名称、系列、编号、语言与版本等公共资料,作为跨页面、跨功能引用的共同记录。

系统里的业务记录

库存数量、采购成本、商品售价和收藏备注由你的业务管理。同一卡牌可对应多个库存批次或收藏副本。

关联后的展示

按卡牌 ID 获取对应资料,再结合本地字段呈现商品或收藏详情。公共资料更新时,业务记录仍保持独立。

先找到记录,再接入业务。

从检索、确认到关联,让卡牌信息在你的产品中保持一致。

01

提交检索条件

从卡名或已知系列开始检索,将业务中已有的线索带入目录查询。

02

核对目标记录

展示候选卡牌的系列、编号、语言与版本,让使用者确认需要的具体记录。

03

保存卡牌关联

将卡牌 ID 关联到商品、库存或收藏记录,公共资料与自己的业务字段分开维护。

在 Playground 试一次

查看请求参数和返回结果。

不只返回卡名, 还返回区分卡牌的依据。

把名称与系列、卡号、版本、语言一起呈现。相似记录也能在搜索和详情中被准确区分。

检索输入
query,按名称或系列搜索
目录输出
items 卡牌记录与 total 匹配数量
业务关联
卡牌 ID 与你的商品或收藏记录
查看卡牌目录接口文档
GET /example/catalog
请求返回
{
  "sample": true,
  "total": 1,
  "items": [
    {
      "card_id": "tcgplayer:509980",
      "name": "Charizard ex",
      "game": "Pokémon",
      "set": "SV03: Obsidian Flames",
      "card_number": "223/197",
      "language": "en",
      "variant": "Holofoil",
      "rarity": "Special Illustration Rare"
    }
  ]
}

让同一张卡牌,在不同场景保持一致。

以统一的目录资料承接搜索、录入与展示。

01

商品资料库

上架时搜索并确认目录记录,统一商品名称、系列与版本展示,让同款商品使用一致的基础资料。

了解应用方案
02

库存标准化

把不同批次的进货记录关联到目录卡牌,名称不同的录入信息也能在核对后归到同一资料记录下。

了解应用方案
03

收藏检索

按卡名搜索,再结合系列、语言与版本确认目标卡牌,保存到个人收藏并添加自己的备注。

了解应用方案

开始接入前,你可能想了解。

还有问题?联系我们

如何区分同名或同画面的卡牌?

应结合系列、卡号、语言与版本等维度确认目标记录。名称或图片本身不足以代表所有发行差异,搜索界面应保留这些比较信息。

卡牌目录与库存管理有什么区别?

目录提供卡牌的公共资料;库存管理保存你持有的具体数量、货位、成本和流转状态。把两者关联后,既能复用卡牌资料,也能保留自己的业务规则。

一次查询有多个结果时如何呈现?

将候选结果列出,并同时展示系列、卡号、语言和版本,供业务端进一步确认。不要只凭名称自动合并不同记录。

目录里有卡牌,就一定有价格和 Pop 吗?

不一定。目录、识别、价格和 Pop 的覆盖范围分别维护。后续查询没有记录时,应展示暂无数据,而不是将缺失值作为零价格或零数量。

现有商品和库存数据如何对接目录?

可先用现有名称、系列与编号匹配候选记录,确认后保存卡牌 ID 的对应关系。保留原有业务 ID,避免因为资料关联改变库存或商品历史。

可以获取批量目录数据吗?

可以。根据卡牌品类、系列、语言与所需字段确定采购范围,并约定交付方式和更新频率。 联系我们讨论数据需求

聊聊你的
卡牌业务。

接入 API、申请 Key,或讨论数据需求。
告诉我们你正在构建什么,一起确定下一步。

  • 从你的场景开始

    了解产品目标、数据范围与调用需求。

  • 找到合适的接入方案

    组合识别、图像处理与数据能力。

  • 沟通试用与服务开通

    确认方案后,协助获取 API Key。

感兴趣的服务可多选

提交即表示你同意我们就本次需求与你联系。

此预览尚未连接需求提交服务。

从一张卡牌,开始调用。

在 Playground 用预设样例查看请求与返回,或联系我们获取 API Key。