# Démarrage rapide Vous créez votre premier article dans la console, vous récupérez son QR, et vous vérifiez qu'il répond publiquement, dans un navigateur puis en ligne de commande. Source : https://docs.sealtrust.io/demarrage-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](#ce-qui-peut-vous-arrêter) donne la réponse exacte du serveur pour les refus les plus courants. > [!INFO] Ce qu'il vous faut > Un compte administrateur sur la console de votre marque, et un navigateur. Rien > à installer. ## 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 ». > [!INFO] QR et NFC > Le QR est un mode d'identification de plein droit. Si vous choisissez NFC ou > NFC + QR, l'article n'est pas frappé tout de suite : il part vers l'étape > d'encodage de la puce, qui demande une puce physique et un lecteur. Pour ce > parcours, restez sur QR. 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 : ```text .../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é. > [!ATTENTION] Ce qui n'apparaît pas encore > Un article qui vient d'être créé n'a ni certificat ni passeport. Le lien vers le > certificat n'apparaît sur cette page qu'une fois le certificat émis, et le lien > vers le passeport qu'une fois le passeport publié. Les deux se font depuis la > console, plus tard. ## 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. :::onglets ```bash title="curl" curl "https://api.sealtrust.io/v1/resolve/DEM000000000" ``` ```typescript 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); ``` ```python 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 | Réponse | Ce qui s'est passé | Que faire | | --- | --- | --- | | Le bouton « Créer » reste grisé | Le nom du produit, la marque ou la catégorie n'est pas renseigné. Les trois sont exigés. | Renseignez les trois champs. Le bouton s'active ensuite. | | 403, détail `{"code": "AUTH_METHOD_NOT_ALLOWED", "allowed": "qr"}` | Vous avez choisi NFC ou NFC + QR, et votre offre n'autorise que le QR. Le détail donne la méthode demandée et celles que votre offre autorise. Les quatre offres du catalogue autorisent le NFC : ce refus ne touche aujourd'hui que les comptes restés sur une ancienne offre limitée au QR. | Choisissez QR pour ce parcours, ou contactez-nous pour ouvrir le NFC sur votre offre. | | 403, détail `{"code": "QUOTA_EXCEEDED", "resource": "products", "period": "monthly", ...}` | La création ferait dépasser le nombre d'articles que votre offre autorise sur le mois. Le détail donne le compte actuel, la quantité demandée et le maximum. | Attendez la période suivante ou faites relever le plafond. | | 403 `Brand must have an active plan` | Aucune offre n'est rattachée à cette marque. | Contactez-nous pour rattacher une offre. | | 404 `Product not found` à l'étape 5 | L'identifiant envoyé ne correspond à aucun article. Le plus souvent, le numéro de série a été retapé au lieu d'être copié. | Recopiez la valeur affichée sur la fiche de l'article. | | 429, corps `{"detail": "Rate limit exceeded: 60 requests per 60s"}` | Vous avez dépassé 60 appels par minute sur le point d'entrée public de l'étape 5. | Attendez le nombre de secondes indiqué par l'en-tête `Retry-After`. | 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](/reference/post-partner-mint-batch/). ## Et ensuite - [Notions](/notions/) : ce que recouvrent produit, modèle, lot, article, certificat, passeport et sceau. - [Créer des produits](/creer-des-produits/) : la création à l'unité et en lot depuis la console, fichier CSV compris. - [GET /resolve/{identifier}](/reference/get-resolve/) : la référence complète du point d'entrée utilisé à l'étape 5. - [POST /partner/mint/batch](/reference/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](/api-vue-ensemble/) : créer une clef d'API, l'authentification et les plafonds d'appels. - [Identification physique](/identification-physique/) : ce que le QR et la puce NFC apportent chacun.