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
POST | Envoyée en HTTPS à l'URL du point de terminaison enregistrée. Les redirections ne sont pas suivies. |
|---|---|
Content-Type | Le corps est l'événement au format JSON, décrit ci-dessous. |
Evd-Signature | L'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
}
}
| Champ | Description |
|---|---|
event_id | Unique pour chaque événement. Ignorez un identifiant déjà traité. |
type | Le nom de l'événement, tiré de la liste en bas de cette page. |
created_at | L'heure de l'événement, en UTC. |
test | Vaut true lorsqu'une clé de test a déclenché l'événement. |
data | L'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 :
- Lisez t (heure Unix en secondes) et v1 dans l'en-tête Evd-Signature.
- Calculez un HMAC-SHA256 avec votre secret sur t, un point et le corps brut de la requête, tel que reçu.
- Comparez le résultat à v1 en temps constant.
- Rejetez la requête si t s'écarte de votre horloge de plus de cinq minutes.
- 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.
secret | example-secret |
|---|---|
t | 1767225600 |
body | {"event_id":"evt_8KQ2M4ZP7T","type":"passport.published"} |
v1 | 21cb13c5a2e80061c64fa3886778905d85dd5b87f2c5ceaa66d88b873dff5b40 |
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énement | Description |
|---|---|
product.created | Un produit a été ajouté. |
product.updated | Les informations d'un produit ont changé. |
item.created | Un numéro de série ou un lot a été ajouté à un produit. |
item.updated | Un numéro de série ou un lot a changé. |
item.published | Le passeport d'un numéro de série ou d'un lot est en ligne. |
item.withdrawn | Un numéro de série ou un lot a été retiré. |
compliance.created | Un certificat ou un enregistrement de conformité a été ajouté. |
compliance.updated | Un enregistrement de conformité a changé. |
document.uploaded | Un document a été téléversé. |
extraction.completed | L'extraction des données d'un document est terminée. |
review.required | Une modification attend une vérification. |
review.approved | Un réviseur a approuvé une modification. |
review.rejected | Un réviseur a rejeté une modification. |
passport.published | Le passeport d'un produit a été publié. |
passport.withdrawn | Le passeport d'un produit a été retiré. |
certificate.expiring | Un certificat expire dans 30 jours ou moins. |
certificate.expired | Un certificat a expiré. |