Démarrage rapide

À la fin de ce parcours, vous avez un article créé, son QR téléchargé, et une adresse publique qui répond à qui la scanne. Tout se passe dans la console de votre marque. Les quatre premières étapes ne demandent aucun code. La cinquième refait la même vérification en ligne de commande.

Chaque étape se termine par une vérification. Si une vérification échoue, ne passez pas à la suivante : la section Ce qui peut vous arrêter donne la réponse exacte du serveur pour les refus les plus courants.

#1. Ouvrez la console

Rendez-vous sur https://admin.sealtrust.io et connectez-vous avec l'adresse électronique et le mot de passe de votre compte.

Vérification. La barre latérale gauche affiche « Premiers pas », « Catalogue » et « Paramètres ».

#2. Créez votre premier article

Dans la barre latérale, ouvrez « Catalogue », puis « Créer un produit ». Restez sur l'onglet « Produit unique ».

Trois champs sont exigés :

• Nom du produit. Le texte que verra le client.
• Marque. Elle est préremplie et verrouillée si votre compte n'en gère qu'une seule. Elle affiche le nom suivi de l'identifiant de la marque entre parenthèses, par exemple Exemple SAS (#12).
• Catégorie. À choisir dans la liste déroulante.

Le champ « Modèle produit (optionnel) » peut rester vide.

Sous ces champs, la ligne « Authentification : » propose trois positions : NFC, QR, NFC + QR. Choisissez QR, puis cliquez sur « Créer ».

Le bouton « Prévisualiser ce qui sera écrit en chaîne » affiche, avant création, ce qui sera inscrit. C'est le dernier moment où quelque chose peut être corrigé.

Vérification. Un bandeau vert affiche « Produit(s) créé(s) avec succès ! », le nom que vous avez saisi, une pastille « QR » et la mention « Mint en cours sur la blockchain... ». Cette dernière signifie que la frappe est lancée en arrière-plan.

#3. Ouvrez la fiche de l'article

Cliquez sur « Voir les produits ». La frappe se fait en arrière-plan. L'article apparaît dans la liste dès que sa transaction blockchain a été envoyée, donc rafraîchissez la page si la liste ne le montre pas encore. Cliquez ensuite sur sa ligne pour ouvrir sa fiche.

Vérification. La fiche affiche un bloc « Blockchain » avec le contrat, le « Tx Hash » et « Date de mint », qui porte la date de la frappe. La ligne « Token ID » ne porte pas encore de valeur : elle se remplit quand la transaction est confirmée en chaîne, ce qui prend un moment de plus. Plus bas, un bloc « QR Code » affiche l'image du code, un bouton « Télécharger QR (PNG) » et la ligne qui donne l'URL de vérification. À l'écran, ce libellé est affiché sans accent.

#4. Ouvrez l'URL de vérification

Copiez la valeur affichée sur cette ligne. Elle se termine par /p/ suivi du numéro de série de l'article, douze caractères en majuscules :

.../p/DEM000000000

Le numéro de série est tiré au sort à la création. Son alphabet écarte les lettres I, L, O et U, pour qu'aucun caractère ne se confonde avec un chiffre quand une personne relit une étiquette.

C'est exactement ce que le QR imprimé encode. Copiez la valeur entière telle qu'elle est affichée, hôte compris. Ne la retapez pas de mémoire.

Ouvrez l'adresse dans un navigateur, en navigation privée, pour voir ce que voit un client.

Vérification. L'adresse mène à la page publique de l'article, qui affiche son nom et sa marque. Aucun compte n'est demandé.

#5. Vérifiez par l'API publique

Même vérification, sans navigateur. Ce point d'entrée ne demande aucune authentification. Remplacez DEM000000000 par le numéro de série relevé à l'étape 4.

curl "https://api.sealtrust.io/v1/resolve/DEM000000000"

const identifiant = "DEM000000000";

const reponse = await fetch(
  `https://api.sealtrust.io/v1/resolve/${encodeURIComponent(identifiant)}`,
);

const donnees = await reponse.json();
console.log(reponse.status);
console.log(donnees.product_name, "-", donnees.brand_name);

import requests

reponse = requests.get(
    "https://api.sealtrust.io/v1/resolve/DEM000000000",
    timeout=30,
)
print(reponse.status_code)
print(reponse.json()["product_name"], "-", reponse.json()["brand_name"])

Vérification. La réponse est un 200. Elle porte product_name et brand_name, qui reprennent ce que vous avez saisi à l'étape 2, ainsi que uid_hash, contract_address et tx_hash. Le champ token_id reste nul jusqu'à la confirmation de la transaction, comme la ligne « Token ID » de l'étape 3. Les champs certificate et passport sont nuls, et media et events sont des listes vides, tant que rien ne les remplit. Un identifiant inconnu répond 404 avec le message Product not found.

Ce point d'entrée accepte quatre formes d'identifiant : le numéro de série imprimé, l'identifiant de jeton, l'empreinte d'article (0x suivi de 64 caractères hexadécimaux) et un numéro de certificat. Il est plafonné à 60 appels par minute et par adresse appelante.

Votre premier article est vérifiable. Le parcours est terminé.

#Ce qui peut vous arrêter

Les réponses qui passent portent aussi les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset : vous pouvez ralentir avant d'atteindre le plafond.

#Et par l'API partenaire

L'API partenaire crée des articles depuis le 21 août 2026. POST /v1/partner/mint/batch prend un lot de lignes, en JSON ou en CSV, jusqu'à 500 lignes par appel. Il répond 200 avec un identifiant de lot, et le traitement crée les articles en arrière-plan. Vous suivez l'avancement avec GET /v1/partner/mint/batch/status/{job_id}. Les deux appels demandent le droit mint:batch sur votre clef d'API.

Deux points à connaître avant d'écrire votre intégration.

• Une ligne de lot porte cinq champs, et cinq seulement : product_name, brand_id, category_id, metadata_uri, et external_ref qui est facultatif. Tout autre champ fait échouer la requête en 400.
• Ce chemin ne produit que des articles QR. Le serveur pose lui-même la méthode d'identification et l'identifiant technique de l'article, et une ligne de lot ne peut pas les porter. Pour des articles NFC, passez par la console.

Le point d'entrée reste décrit champ par champ, avec ses autorisations, ses plafonds et la liste de ses erreurs, sur sa page de référence, POST /partner/mint/batch.

#Et ensuite

• Notions : ce que recouvrent produit, modèle, lot, article, certificat, passeport et sceau.
• Créer des produits : la création à l'unité et en lot depuis la console, fichier CSV compris.
• GET /resolve/{identifier} : la référence complète du point d'entrée utilisé à l'étape 5.
• POST /partner/mint/batch : la référence complète du point d'entrée décrit juste au-dessus.
• API partenaire, vue d'ensemble : créer une clef d'API, l'authentification et les plafonds d'appels.
• Identification physique : ce que le QR et la puce NFC apportent chacun.