MostlyQR

Codes sérialisés

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

Le modèle a trois niveaux :

  • Campagne — le produit/SKU : une destination + une marque + un statut. Créé dans le tableau de bord (onglet Serialized) 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 serial (mqr.sh/u/<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 à l’impression.

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": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Interroger le travail de frappe

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

# Exporter un bundle prêt à l’impression

Une fois frappées, construisez un manifeste (CSV + JSONL optionnel de chaque serial + son URL) et obtenez une URL de téléchargement signée de courte durée — remettez-la à votre vendeur 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 numérique

Chaque serial peut être rendu sous forme de code QR, de DataMatrix ECC200 (emballage serré) ou de GS1 Digital Link portant GTIN + lot + expiration + serial. 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 serial apparaissant dans des zones géographiques dispersées, ou un déplacement impossible) et déclenchent un webhook clone.suspected sur la transition de drapeau. Les verdicts s’affichent publiquement via Vérification.

# Notes

  • La frappe est restreinte à l’allocation serialized_codes du plan Enterprise — une clé non-Enterprise reçoit 403.
  • Les unités sont des documents ultra-légers, donc une campagne peut accueillir des millions sans surcharge par unité.

# Suivant