Webhook
Saat data perusahaan Anda berubah, kami mengirim permintaan HTTPS ke setiap endpoint yang berlangganan event tersebut. Tambahkan endpoint di dasbor, pada menu Integrasi.
Permintaan
POST | Dikirim melalui HTTPS ke URL endpoint yang Anda simpan. Pengalihan tidak diikuti. |
|---|---|
Content-Type | Isi permintaan adalah event dalam format JSON, dijelaskan di bawah. |
Evd-Signature | Waktu permintaan ditandatangani dan tanda tangan HMAC-SHA256-nya. |
Payload
Setiap event memakai struktur yang sama. Kolom data berisi catatan yang terdampak.
{
"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
}
}
| Kolom | Deskripsi |
|---|---|
event_id | Unik untuk setiap event. Lewati ID yang sudah Anda proses. |
type | Nama event, dari daftar di akhir halaman ini. |
created_at | Waktu event terjadi, dalam UTC. |
test | Bernilai true jika event dipicu oleh kunci uji. |
data | Catatan yang terdampak, sama seperti yang dikembalikan endpoint GET-nya. |
Verifikasi tanda tangan
Setiap endpoint punya rahasia penandatanganan sendiri, yang ditampilkan sekali saat endpoint ditambahkan. Periksa setiap permintaan sebelum memprosesnya:
- Baca t (waktu Unix dalam detik) dan v1 dari header Evd-Signature.
- Hitung HMAC-SHA256 dengan rahasia Anda atas t, sebuah titik, dan isi permintaan mentah persis seperti yang diterima.
- Bandingkan hasilnya dengan v1 menggunakan perbandingan waktu konstan.
- Tolak permintaan jika t berselisih lebih dari lima menit dari jam Anda.
- Lewati ID event yang sudah Anda proses, lalu balas dengan status 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;
}Periksa kode Anda
Dengan rahasia, stempel waktu, dan isi ini, kode Anda harus menghasilkan nilai v1 ini.
secret | example-secret |
|---|---|
t | 1767225600 |
body | {"event_id":"evt_8KQ2M4ZP7T","type":"passport.published"} |
v1 | 21cb13c5a2e80061c64fa3886778905d85dd5b87f2c5ceaa66d88b873dff5b40 |
Percobaan ulang dan pengiriman ulang
Balas dengan cepat dan kerjakan proses yang lambat setelahnya. Respons di luar 2xx, pengalihan, atau batas waktu habis dihitung sebagai percobaan gagal. Kami mencoba ulang hingga 8 kali selama sekitar 24 jam, lalu menandai pengiriman sebagai gagal. Anda bisa mengirim ulang pengiriman mana pun dari dasbor atau API.
Event
Pilih event yang diterima setiap endpoint.
| Event | Deskripsi |
|---|---|
product.created | Produk ditambahkan. |
product.updated | Detail produk berubah. |
item.created | Nomor seri atau lot ditambahkan ke produk. |
item.updated | Nomor seri atau lot berubah. |
item.published | Paspor nomor seri atau lot sudah tayang. |
item.withdrawn | Nomor seri atau lot ditarik. |
compliance.created | Sertifikat atau catatan kepatuhan ditambahkan. |
compliance.updated | Catatan kepatuhan berubah. |
document.uploaded | Dokumen diunggah. |
extraction.completed | Ekstraksi data dari dokumen selesai. |
review.required | Ada perubahan yang menunggu tinjauan. |
review.approved | Peninjau menyetujui perubahan. |
review.rejected | Peninjau menolak perubahan. |
passport.published | Paspor produk diterbitkan. |
passport.withdrawn | Paspor produk ditarik. |
certificate.expiring | Sertifikat akan kedaluwarsa dalam 30 hari. |
certificate.expired | Sertifikat sudah kedaluwarsa. |