API publique de vérification de certificat

Les marques et les places de marché peuvent interroger Label Registry automatiquement. La réponse reprend ce que l'on voit sur les pages publiques certificat et vérification : titulaire, périmètre, validité, statut effectif, notes d'historique publiées et allégations publiques le cas échéant. Aucun nom de personne ni e-mail privé n'est renvoyé.

Vue d'ensemble

PublicApiDocs.overviewBody

Point d'accès

Remplacez l'identifiant dans le chemin par un numéro de certificat publié ou par le jeton public d'un lien de vérification QR.

GET https://glint-label-registry.vercel.app/api/public/v1/certificates/ECOV-2026-000001

Identifiant de certificat

PublicApiDocs.identifierBody

Exemple de réponse

effectiveStatus tient compte de l'expiration calendaire même si le statut stocké est encore ACTIVE. Lorsque des allégations sont publiées sur la page certificat, elles apparaissent dans claims avec les mêmes métadonnées de preuve publique.

{
  "schemaVersion": "1",
  "generatedAt": "2026-10-20T09:00:00.000Z",
  "certificate": {
    "number": "ECOV-2026-000001",
    "status": "ACTIVE",
    "effectiveStatus": "ACTIVE",
    "hasConditions": false,
    "holder": {
      "legalName": "Atelier du Foron SAS",
      "country": "FR",
      "legalEntityId": "900000043"
    },
    "scheme": {
      "slug": "vallee-verte",
      "name": { "fr": "Label Vallée Verte", "en": "Green Valley Label" },
      "version": 1
    },
    "scope": "Miel de montagne, miellerie de Fillinges.",
    "validFrom": "2026-09-01",
    "validUntil": "2029-08-31",
    "verifier": { "name": "Alpes Contrôle" },
    "history": [
      {
        "status": "ACTIVE",
        "at": "2026-09-01T09:00:00.000Z",
        "note": { "fr": "Certificat accordé.", "en": null }
      }
    ],
    "verifyUrl": "https://glint-label-registry.vercel.app/fr/verify/seedtokenECOV2026000001"
  },
  "claims": [],
  "disclaimer": "Status reflects the scheme owner's decision. Label Registry is software and does not certify."
}

Erreurs

Un certificat absent ou un schéma non publié renvoie 404. Au delà de la limite de débit, le serveur renvoie 429 avec Retry-After et les en-têtes X-RateLimit.

HTTP/1.1 404 Not Found
{ "error": "not_found" }

HTTP/1.1 429 Too Many Requests
{ "error": "rate_limited" }

Limite de débit

Chaque adresse IP cliente peut envoyer jusqu'à 60 requêtes GET par 60 secondes sur ce point d'accès. Les intégrateurs doivent mettre en cache les réponses (l'API envoie déjà Cache-Control) et ralentir lorsqu'ils reçoivent 429.

Voir aussi

PublicApiDocs.relatedBody

Ouvrir le registre public