唯一的公开接口

无需密钥、无需注册，只读。本站查询页调用的正是此接口，别无其他。

GET https://filament.yumi-lab.com/v1/public/spool?lot=20250914001234X001&ean=6975337080015

返回内容

{
  "produit_nom": "PLA Ultra Speed 1kg",
  "couleur_nom": "Steel Blue",
  "hex_officiel": "627EAC",
  "hex_mesure": "627EAC",
  "td": 1.9,
  "qc_valide": true
}

字段	含义
`produit_nom`	由条码解析出的产品名称，可能为空。
`couleur_nom`	标准颜色名称。在录入标准之前为空。
`hex_officiel`	产品标准颜色。在录入标准之前为空。
`hex_mesure`	该批次的实测颜色，始终存在。
`td`	该批次的实测透光值，始终存在。
`qc_valide`	在操作员确认之前为 false。

错误响应

404 not_found: 批次号与条码的组合无记录。无论是批次不存在、条码不匹配还是产品未知，返回内容完全相同：加以区分会泄露哪些批次真实存在。
429 too_many_requests: 同一地址请求过于频繁。重试响应头会给出需等待的秒数。

本登记库的局限

返回内容不含任何日期：既无生产日期、测量日期、导入日期，也无递增标识。但批次号本身含有生产日期，这无法去除，它就印在标签上。因此这并非一种保护，而是一种规范，我们如实说明而非做出承诺。

色差以 HEX 值按 ΔE00 (CIEDE2000) 计算。这是一个近似值：色度计的光源与观察者条件未知。足以发现偏移，但不足以据此裁定争议。