MostlyQR

Codes sérialisés

Donnez à chaque unité physique son propre code unique — non pas un code par ligne de produit, mais un numéro de série distinct et non énumérable par article. Cela déverrouille l’analytique par unité, le rappel et la vérification anti-contrefaçon. Plan Entreprise.

Le modèle comporte trois niveaux :

  • Campagne — le produit/SKU : une destination + marque + statut. Créée dans le tableau de bord (onglet Sérialisé) ou via l’API du tableau de bord.
  • Lot — un lot de production sous une campagne (créé au moment de la frappe).
  • Unité — un article physique, identifié par son numéro de série (mqr.sh/<serial>).

# Frapper un lot

count unités sont frappées de manière asynchrone sous une campagne ; vous interrogez le travail, puis exportez un manifeste prêt à imprimer.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/mint \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "count": 100000, "label": "Spring run 04" }'
json
{ "job_id": "9f3a2c7b", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Interroger le travail de frappe

bash
curl https://mostlyqr.com/api/v1/serialized/jobs/9f3a2c7b \
  -H "Authorization: Bearer mtq_live_…"
json
{ "job_id": "9f3a2c7b", "status": "running", "total": 100000, "minted": 42000, "progress": 0.42 }

# Exporter un bundle prêt à imprimer

Une fois frappé, construisez un manifeste (CSV + JSONL optionnel de chaque numéro de série + son URL) et obtenez une URL de téléchargement signée de courte durée — remettez-la à votre fournisseur d’impression/d’emballage.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/export \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "batch_id": "b-1718…", "includeJsonl": true }'
json
{ "url": "https://…signed…/spring-run-04.zip", "count": 100000, "filename": "spring-run-04.zip", "expires_in_ms": 86400000 }

# Symbologie et passeport produit

Chaque numéro de série peut être rendu sous forme de code QR, de DataMatrix ECC200 (emballage serré) ou de lien numérique GS1 portant GTIN + lot + expiration + numéro de série. Vous pouvez également joindre un passeport produit numérique (Modèle, Année de sortie, Matériau…) affiché lors de la vérification d’une unité.

# Anti-contrefaçon

Les scans par unité exécutent une heuristique de détection de clone (le même numéro de série apparaissant dans des géographies dispersées, ou un voyage impossible) et déclenchent un webhook clone.suspected à la transition du drapeau. Les verdicts apparaissent publiquement via Vérification.

# Notes

  • La frappe est limitée à l’allocation serialized_codes du plan Entreprise — une clé non-Entreprise (ou une frappe qui dépasserait l’allocation) obtient 409 (failed-precondition), avec la limite dans le message.
  • Les unités sont des documents ultra-légers, donc une campagne peut supporter des millions sans surcharge par unité.

# Suivant