API et intégrations

Une plateforme pensée d'abord comme une API

Un développeur devant un écran de code : l'accès programmatique aux passeports numériques de produit.

Tout ce que fait l'interface passe par l'API

La plateforme WIARA a été conçue comme une API avant d'avoir une interface. Le tableau de bord que vous utilisez dialogue avec la même interface de programmation que celle qui vous est fournie : il n'existe ni mode privé ni fonction accessible uniquement derrière un bouton. L'intégration n'est donc pas un ajout à la plateforme, c'est la plateforme elle-même.

Il y a deux interfaces. La première sert à l'intégration et à l'administration : plus d'une centaine d'opérations documentées selon OpenAPI 3.0.3 (passeports, gabarits, organisations, fichiers, piste d'audit, statistiques). La seconde est publique et en lecture seule : c'est par elle que chacun ouvre les passeports eux-mêmes.

Nous envoyons la spécification complète aux équipes qui réalisent une intégration : il suffit de la demander. Vous pouvez aussi consulter les normes techniques sur lesquelles repose la plateforme, ou le produit lui-même →

Ce que vous pouvez automatiser

API et intégrations

Deux interfaces, un seul contrat

Une API d'intégration pour vos systèmes et une API publique en lecture seule pour les passeports eux-mêmes. Toutes deux documentées selon OpenAPI 3.0.3.

Résolveur GS1 Digital Link

Les passeports s'ouvrent par leur identifiant GS1 Digital Link. Le résolveur est conforme à la norme ISO/IEC 18975, pas à un schéma propriétaire.

Modèle, lot, article

Les trois niveaux de granularité, plus les variantes de produit. Le même standard de QR code, quel que soit le niveau que retiendra l'acte délégué qui vous concerne.

Brouillon, aperçu, publication

Un passeport est préparé en brouillon, relu via un lien protégé et publié quand il est prêt. Chaque version reste dans l'historique.

Piste d'audit à la demande

Qui a modifié quoi : par objet, par utilisateur, par fabricant, par opérateur, par plateforme. Pas un long journal à parcourir, mais une question qui obtient sa réponse.

24 langues, par programmation

Les valeurs du passeport sont gérées langue par langue. La traduction automatique s'active ou se désactive pour chaque passeport.

Ce que couvre l'accès programmatique

Chacun des domaines ci-dessous se pilote entièrement par l'API, sans aucune étape manuelle dans l'interface.

Cycle de vie du passeport

✅ Création, modification, brouillon, aperçu via un lien protégé, publication et historique complet des versions.

Gabarits

✅ Création et gestion des versions des gabarits, statut par version, traductions par langue et gabarits sur mesure attribués à un seul fabricant.

Organisations

✅ Plateformes, opérateurs et fabricants, avec leurs adresses et contacts, y compris le transfert de propriété.

Liaison opérateur ↔ fabricant

✅ Codes d'invitation, aperçu avant acceptation, acceptation au nom de votre propre organisation et dissociation.

Fichiers et justificatifs

✅ Import sécurisé, historique des versions pour chaque fichier et liens de téléchargement signés, valables pour une durée limitée.

Piste d'audit

✅ Requêtes par objet, par acteur et par organisation, conçues pour répondre à un auditeur, pas pour être parcourues.

Statistiques

✅ Indicateurs et séries temporelles par périmètre, pour vos tableaux de bord et pas seulement pour les nôtres.

Accès et jetons

✅ Jetons d'accès personnels émis et révoqués pour chaque utilisateur, sous contrôle administratif.

Taxonomie

✅ Règlements et groupes de produits gérés comme des données : un nouveau groupe de produits s'ajoute, sans refonte.

Lecture publique

✅ Ouverture d'un passeport par GS1 Digital Link au niveau du modèle, du lot ou de l'article, variantes comprises ; un passeport retiré renvoie une réponse qui le signale clairement au lieu de rester muet.

API et intégrations

Questions fréquentes

Oui. La spécification OpenAPI complète n'est pas publiée en accès libre, mais nous l'envoyons à toute équipe qui prépare une intégration : il suffit de nous la demander. La documentation parvient ainsi à ceux qui l'utilisent plutôt qu'à ceux qui la copient.

Oui. L'interface est un client du même accès programmatique que celui qui vous est fourni. C'est toute la différence entre une plateforme dotée d'une API et une plateforme à laquelle on a ajouté une API.

Oui. La création et la mise à jour des passeports, l'import de documents et la gestion des organisations sont toutes des opérations programmatiques : votre système peut les appeler directement. Le bon schéma d'intégration dépend de votre système ; c'est un sujet à aborder avec l'un de nos ingénieurs, pas une recette toute faite.

Par GS1 Digital Link, la méthode standard pour qu'un QR code pointe vers un produit. Le résolveur est conforme à la norme ISO/IEC 18975, et l'identifiant lui-même repose sur le GTIN.

La réponse permet de le distinguer. Un passeport publié qui n'est plus valide n'est pas présenté comme s'il n'avait jamais existé : le système qui le lit voit la différence et peut agir en conséquence.

Pas encore. EPCIS 2.0 est une extension prévue pour les secteurs où la traçabilité est intensive ; le passeport de base n'en a pas besoin. Nous préférons le dire plutôt que de laisser croire le contraire.

Une équipe technique en réunion de travail : l'intégration d'une plateforme DPP.
Normes ouvertesAccès programmatique
Normes ouvertesAccès programmatique
Dernière vérification le

DigitalProductPassport dans d’autres pays: Albanie · Bulgarie · Croatie · Grèce · Hongrie · Pologne · Roumanie · Serbie · Slovaquie · Slovénie · Tchéquie · Union européenne