Exposez vos preuves vérifiables directement sur vos fiches produits
API REST · Badges · QR codes · Webhooks (roadmap)
L'API GAIALED permet à vos clients et parties prenantes de vérifier publiquement vos claims environnementaux directement depuis vos fiches produits e-commerce (PLP/PDP) ou supports marketing.
Note : Cette page décrit les capacités futures de l'API (roadmap). Actuellement en MVP, nous proposons Evidence Binder PDF + QR codes téléchargeables manuellement.
Récupérez les métadonnées d'un claim : ID, label (ex. "Recycled content ≥30%"), statut (Evidenced/Verified/Timestamped), dates de création/expiration.
Obtenez l'URL du dossier de preuves PDF complet (Evidence Binder) pour téléchargement ou affichage modal sur votre site.
Récupérez l'empreinte cryptographique (SHA-256) et le timestamp RFC3161 (quand activé) pour vérification d'intégrité.
Les endpoints ci-dessous sont présentés à titre indicatif. La documentation technique complète sera fournie lors de l'accès API (actuellement en développement).
Récupère les métadonnées d'un claim spécifique.
Réponse : JSON avec claim ID, label, statut, dates (created_at, expires_at), marque, produit.
Récupère les liens vers les preuves (Evidence Binder PDF, QR code PNG).
Réponse : JSON avec URLs des fichiers de preuves, hash SHA-256, timestamp (si activé).
Vérifie l'intégrité cryptographique d'un claim (hash + timestamp RFC3161).
Réponse : JSON avec status (valid/invalid), hash attendu vs. actuel, timestamp TSA.
[Roadmap] Liste tous les claims d'une marque spécifique.
Permet d'afficher une "page marque" avec tous ses claims vérifiables.
Format : JSON · Encodage : UTF-8 · Taux limite : À définir (rate limiting à venir)
Badge visuel affichant le statut d'un claim (Evidenced / Verified / Timestamped) directement sur vos fiches produits (PLP/PDP).
Intégration : Embed HTML/CSS ou iframe. Cliquable → modal Evidence Binder.
QR code généré dynamiquement, pointant vers la page de vérification publique (https://gaialed.ch/verify/[claim_id]). Idéal pour packaging physique ou PLV.
Format : PNG, SVG · Tailles : 128x128, 256x256, 512x512 px
Composant JavaScript prêt à l'emploi affichant l'Evidence Binder PDF dans une modale lightbox sur votre site (évite redirection externe).
Intégration : 1-clic via CDN JavaScript :
<script src="https://cdn.gaialed.ch/widget/v1/modal.js"></script>
Note : CDN widget en développement (roadmap Q1 2026).
Notifications temps réel lors de mises à jour de claims (renouvellement, expiration proche, changement de statut). Synchronisation automatique PIM/ERP.
Événements : claim.created, claim.updated, claim.expired, claim.renewed
Disponibilité : Q2 2026 (roadmap)
L'API est en lecture seule (GET only). Aucune écriture/suppression de claims possible via API. La gestion se fait exclusivement via interface web sécurisée (login/2FA).
Quotas d'appels API selon offre : Starter (1000 req/jour), Professional (10'000 req/jour), Enterprise (sur devis, illimité).
Toutes les requêtes API doivent utiliser HTTPS (TLS 1.3). Les connexions HTTP non chiffrées sont refusées (301 redirect).
Status API disponible publiquement sur status.gaialed.ch. Uptime cible : 99.5% (MVP) / 99.9% (Enterprise).
L'API GAIALED est actuellement en accès restreint (bêta privée). Contactez-nous pour rejoindre le programme pilote.
📧 Demander l'accès API →Nous vous répondrons sous 48h ouvrées avec la documentation technique complète.