Tous les points d'entrée
La liste complète des points d'entrée de l'API SealTrust, groupe par groupe, avec ce que chacun rend.
Sur cette page
Cette page rassemble en une seule liste tous les points d'entrée décrits par la référence. Vous y trouvez le verbe, le chemin, et une phrase qui dit ce que l'appel rend. Le sommaire de droite vous emmène directement au groupe qui vous intéresse.
Chaque entrée mène à sa page de référence. C'est là que vous lisez les paramètres exacts, la forme de la réponse et les codes d'erreur, avec un exemple de requête et un exemple de réponse.
Deux lectures à faire avant celle-ci si vous ouvrez l'API pour la première fois : la vue d'ensemble de l'API partenaire, qui donne l'adresse de base et l'authentification, et les erreurs de l'API, qui donne la forme commune à toutes les réponses de refus.
Créer des produits
- Méthode POST/partner
/mint /batchEnvoyer un lot de lignes de produits, en JSON ou en CSV, jusqu'à 500 lignes par appel. Droit mint:batch. Les produits créés par cette voie sont identifiés par QR. - Méthode GET/partner
/mint /batch /status /{job_id}Lit l'avancement d'un lot de produits envoyé à la frappe, à partir de l'identifiant rendu au moment de l'envoi.
Déclarer une vente
Recevoir les événements
- Méthode POST/partner
/webhooksEnregistrer une adresse HTTPS qui recevra les événements de votre marque, et choisir les types d'événements envoyés à cette adresse. Droit webhooks:write. - Méthode GET/partner
/webhooksLister les abonnements aux notifications enregistrés au nom de votre marque, page par page. Droit webhooks:read. - Méthode GET/partner
/webhooks /{webhook_id}Lire un abonnement aux notifications de votre marque, avec son adresse, ses types d'événements et son état de livraison. Droit webhooks:read. - Méthode PUT/partner
/webhooks /{webhook_id}Modifier un abonnement aux notifications : son adresse de destination, sa liste d'événements, son secret de signature, son activation. Droit webhooks:write. - Méthode DELETE/partner
/webhooks /{webhook_id}Supprimer définitivement un abonnement aux notifications et le secret de signature qui lui est attaché. Droit webhooks:write, et confirmation obligatoire par l'adresse de l'abonnement.
Intervenir sur un produit
- Méthode GET/partner-portal
/meLire votre profil de partenaire et la liste des marques qui vous ont accrédité. Session de compte partenaire, aucun droit de clef d'API. - Méthode GET/partner-portal
/products /{identifier}Retrouver un produit d'une marque qui vous a accrédité, à partir de ce qui est écrit sur l'objet, et lire son passeport filtré sur les seules accréditations que cette marque vous a reconnues. - Méthode POST/partner-portal
/interventionsEnregistrer une intervention sur un produit depuis un compte partenaire réparateur ou recycleur. Session partenaire, aucune clef d'API. - Méthode GET/partner-portal
/interventionsLister les interventions que votre compte partenaire a enregistrées, de la plus récente à la plus ancienne. Session de compte partenaire.
Vérifier un produit
- Méthode GET/products
/{uid} /publicLire les informations publiques d'un produit à partir de son identifiant : nom, marque, image, jeton, transaction, état et déclaration de vol. Aucune clef d'API. - Méthode GET/resolve
/{identifier}Lire en un seul appel tout ce qu'une page produit affiche : identité, certificat, passeport public, médias, historique et preuves d'ancrage. Point d'entrée public, sans clef d'API. - Méthode GET/qr
/verifyVérifier un article à partir des paramètres signés portés par une adresse de vérification de l'ancienne forme. Point d'entrée public, sans clef d'API. - Méthode GET/verify
/merkle /{identifier}Récupérer la preuve d'appartenance d'un article au lot ancré sur Base, avec sa feuille, sa preuve de voisinage et la racine inscrite sur la chaîne. Point d'entrée public. - Méthode GET/timeline
/{identifier}Lire l'historique public d'un produit : ses vérifications et ses changements de propriétaire, à partir du numéro imprimé, de l'identifiant de jeton ou de l'empreinte de puce. Point d'entrée public. - Méthode POST/originality
/read-sig /verifyContrôler la signature d'originalité NXP Read_Sig d'une puce, à partir de son numéro de série et de la signature lue sur la puce. Point d'entrée public, sans clef d'API.
Remettre un certificat
- Méthode GET/certificate
/{identifier}Lire le certificat d'authenticité d'un produit à partir de son numéro de certificat, de son empreinte d'UID, de son identifiant de jeton ou du numéro de série imprimé. Point d'entrée public. - Méthode GET/certificate
/{identifier} /downloadTélécharger le certificat d'authenticité d'un article au format PDF, aux couleurs de votre marque. Point d'entrée public, sans clef d'API.
Lire un passeport
- Méthode GET/passport
/{identifier}Lire le passeport numérique publié d'un produit à partir de son numéro imprimé, de son identifiant de jeton ou de son empreinte de puce, au niveau d'accès demandé. Point d'entrée public. - Méthode GET/passport
/01 /{gtin}Lire le passeport numérique publié pour un modèle de produit, à partir de son GTIN. Aucune clef d'API pour le niveau public. - Méthode GET/passport
/{identifier} /verifyContrôler l'intégrité du passeport publié d'un article : empreinte enregistrée, copie publique immuable et sceau de version. Point d'entrée public. - Méthode GET/passport
/{identifier} /proofRassembler en un appel toutes les preuves publiques d'un passeport : empreinte du contenu, copie IPFS, ancrage sur Base, sceau de version et état du justificatif signé. Point d'entrée public. - Méthode GET/passport
/01 /{gtin} /proofRécupérer les preuves publiques du passeport de référence annoncé par un GTIN : empreinte du contenu, copie IPFS vérifiée, ancrage du document sur Base et état de l'attestation signée. Point d'entrée public.
Résoudre un code
- Méthode GET/p
/{serial}Traduire le numéro de série imprimé sur un article en adresse de sa page consommateur. Point d'entrée public, sans clef d'API, qui répond par une redirection. - Méthode GET/01
/{gtin} /21 /{serial}Résoudre un GS1 Digital Link (AI 01 + AI 21) vers la page publique de l'article. Point d'entrée public, sans clef d'API, qui répond par une redirection. - Méthode GET/01
/{gtin}Résoudre un lien GS1 Digital Link qui ne porte qu'un GTIN, vers la page publique du passeport de référence du modèle. Réponse 302, aucune clef d'API.
Attester avec une signature
- Méthode GET/passport
/{identifier} /vc /previewVoir, sans signature et sans rien enregistrer, l'enveloppe de justificatif vérifiable et le document JSON-LD qu'un niveau d'accès donné exposerait pour un passeport. - Méthode GET/passport
/{identifier} /vcRécupérer le justificatif signé d'un passeport, au format SD-JWT-VC, filtré au niveau d'accès demandé. Point d'entrée public aux niveaux public et end_user. - Méthode GET/passport
/{identifier} /vc /verifyContrôler la signature du passeport numérique délivré sous forme d'attestation vérifiable, et lire les données révélées au niveau d'accès demandé. Aucune session n'est demandée pour les niveaux public et end_user. - Méthode GET/brand
/{brand_id} /did.jsonRécupérer le document d'identité d'une marque : la liste de ses clefs publiques de signature, au format did:web. Point d'entrée public. - Méthode GET/.well-known
/did.jsonServir le document d'identité décentralisée d'une marque sur son propre nom de domaine, en mode délégué. Point d'entrée public, résolu d'après le nom d'hôte appelé.
Cette page vous a-t-elle été utile ?
Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.