Everdeen Passport
Français
Commencer gratuitement

Webhooks

Lorsque les données de votre entreprise changent, nous envoyons une requête HTTPS à chaque point de terminaison abonné à cet événement. Ajoutez des points de terminaison dans le tableau de bord, sous Intégrations.

Requête

POSTEnvoyée en HTTPS à l'URL du point de terminaison enregistrée. Les redirections ne sont pas suivies.
Content-TypeLe corps est l'événement au format JSON, décrit ci-dessous.
Evd-SignatureL'heure de signature de la requête et sa signature HMAC-SHA256.

Contenu

Tous les événements utilisent la même enveloppe. Le champ data contient l'enregistrement concerné.

{
  "event_id": "evt_8KQ2M4ZP7T",
  "type": "passport.published",
  "created_at": "2026-10-31T02:15:00Z",
  "test": false,
  "data": {
    "product_id": "prd_5F3K9W",
    "version": 3,
    "state": "PUBLISHED",
    "signature_id": "sig_2RT8LQ",
    "resolver_url": "https://pass.everdeenone.com/01/09506000134352",
    "published_at": "2026-10-31T02:15:00Z",
    "withdrawn_at": null
  }
}
ChampDescription
event_idUnique pour chaque événement. Ignorez un identifiant déjà traité.
typeLe nom de l'événement, tiré de la liste en bas de cette page.
created_atL'heure de l'événement, en UTC.
testVaut true lorsqu'une clé de test a déclenché l'événement.
dataL'enregistrement concerné, tel que le renvoie son point de terminaison GET.

Vérifier la signature

Chaque point de terminaison a son propre secret de signature, affiché une seule fois à l'ajout. Vérifiez chaque requête avant d'agir :

  1. Lisez t (heure Unix en secondes) et v1 dans l'en-tête Evd-Signature.
  2. Calculez un HMAC-SHA256 avec votre secret sur t, un point et le corps brut de la requête, tel que reçu.
  3. Comparez le résultat à v1 en temps constant.
  4. Rejetez la requête si t s'écarte de votre horloge de plus de cinq minutes.
  5. Ignorez un identifiant d'événement déjà traité, puis répondez avec un statut 2xx.
import crypto from "node:crypto";

// rawBody: the request body as received (a Buffer), before JSON parsing.
export function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(
    header.split(",").map((p) => [p.slice(0, p.indexOf("=")), p.slice(p.indexOf("=") + 1)]),
  );
  const t = Number(parts.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.`)
    .update(rawBody)
    .digest();
  const given = Buffer.from(parts.v1 ?? "", "hex");
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}
import hashlib, hmac, time

# raw_body: the request body as received (bytes), before JSON parsing.
def verify(raw_body: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t = parts.get("t", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    expected = hmac.new(
        secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))
// rawBody: the request body as received, before JSON decoding.
func Verify(rawBody []byte, header, secret string) bool {
	var t, v1 string
	for _, p := range strings.Split(header, ",") {
		k, v, _ := strings.Cut(p, "=")
		switch k {
		case "t":
			t = v
		case "v1":
			v1 = v
		}
	}
	ts, err := strconv.ParseInt(t, 10, 64)
	if age := time.Now().Unix() - ts; err != nil || age > 300 || age < -300 {
		return false
	}
	mac := hmac.New(sha256.New, []byte(secret))
	mac.Write([]byte(t + "."))
	mac.Write(rawBody)
	given, err := hex.DecodeString(v1)
	return err == nil && hmac.Equal(given, mac.Sum(nil))
}
import 'dart:convert';
import 'package:crypto/crypto.dart';

// rawBody: the request body as received, before JSON decoding.
bool verify(List<int> rawBody, String header, String secret) {
  final parts = <String, String>{};
  for (final p in header.split(',')) {
    final i = p.indexOf('=');
    if (i > 0) parts[p.substring(0, i)] = p.substring(i + 1);
  }
  final t = int.tryParse(parts['t'] ?? '');
  final now = DateTime.now().millisecondsSinceEpoch ~/ 1000;
  if (t == null || (now - t).abs() > 300) return false;
  final mac = Hmac(sha256, utf8.encode(secret))
      .convert([...utf8.encode('${parts['t']}.'), ...rawBody]);
  final expected = mac.toString();
  final given = parts['v1'] ?? '';
  if (given.length != expected.length) return false;
  var diff = 0;
  for (var i = 0; i < given.length; i++) {
    diff |= given.codeUnitAt(i) ^ expected.codeUnitAt(i);
  }
  return diff == 0;
}

Testez votre code

Avec ce secret, cet horodatage et ce corps, votre code doit calculer cette valeur v1.

secretexample-secret
t1767225600
body{"event_id":"evt_8KQ2M4ZP7T","type":"passport.published"}
v121cb13c5a2e80061c64fa3886778905d85dd5b87f2c5ceaa66d88b873dff5b40

Nouvelles tentatives et renvoi

Répondez vite et faites le travail long ensuite. Une réponse hors 2xx, une redirection ou un délai dépassé compte comme un échec. Nous réessayons jusqu'à 8 fois sur environ 24 heures, puis marquons la livraison comme échouée. Vous pouvez renvoyer toute livraison depuis le tableau de bord ou l'API.

Événements

Choisissez les événements que reçoit chaque point de terminaison.

ÉvénementDescription
product.createdUn produit a été ajouté.
product.updatedLes informations d'un produit ont changé.
item.createdUn numéro de série ou un lot a été ajouté à un produit.
item.updatedUn numéro de série ou un lot a changé.
item.publishedLe passeport d'un numéro de série ou d'un lot est en ligne.
item.withdrawnUn numéro de série ou un lot a été retiré.
compliance.createdUn certificat ou un enregistrement de conformité a été ajouté.
compliance.updatedUn enregistrement de conformité a changé.
document.uploadedUn document a été téléversé.
extraction.completedL'extraction des données d'un document est terminée.
review.requiredUne modification attend une vérification.
review.approvedUn réviseur a approuvé une modification.
review.rejectedUn réviseur a rejeté une modification.
passport.publishedLe passeport d'un produit a été publié.
passport.withdrawnLe passeport d'un produit a été retiré.
certificate.expiringUn certificat expire dans 30 jours ou moins.
certificate.expiredUn certificat a expiré.