Une seule route publique

Sans clé, sans inscription, en lecture. La page de consultation de ce site appelle exactement cette route — il n'en existe pas d'autre.

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

La réponse

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

Champ	Ce qu'il dit
`produit_nom`	Le nom du produit, résolu depuis le code-barres. Peut manquer.
`couleur_nom`	Le nom de la couleur de référence. Manque tant qu'aucune référence n'est saisie.
`hex_officiel`	La couleur de référence du produit. Manque tant qu'aucune référence n'est saisie.
`hex_mesure`	La couleur mesurée SUR CE LOT. Toujours présente.
`td`	La transmission mesurée sur ce lot. Toujours présente.
`qc_valide`	Faux tant qu'un opérateur n'a pas confirmé la mesure.

Les refus

404 not_found: Le couple lot + code-barres est inconnu. La réponse est IDENTIQUE que le lot n'existe pas, que le code-barres ne corresponde pas, ou que le produit soit inconnu : distinguer ces cas apprendrait quels lots existent.
429 too_many_requests: Trop de requêtes depuis la même adresse. L'en-tête d'attente indique combien de secondes patienter.

Ce que ce registre ne dit pas

La réponse ne porte AUCUNE date : ni fabrication, ni mesure, ni import, ni identifiant croissant. Le numéro de lot, lui, contient sa date de fabrication — on ne peut pas l'en retirer, il est imprimé sur l'étiquette. Ce n'est donc pas une protection : c'est une hygiène, et elle est dite honnêtement plutôt que promise.

L'écart de couleur est calculé en ΔE00 (CIEDE2000) à partir d'un code HEX. C'est une APPROXIMATION : l'illuminant et l'observateur du colorimètre sont inconnus. Suffisant pour détecter une dérive, insuffisant pour arbitrer un litige au dixième.