Everdeen Passport
Bahasa Indonesia
Mulai gratis

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

POSTDikirim melalui HTTPS ke URL endpoint yang Anda simpan. Pengalihan tidak diikuti.
Content-TypeIsi permintaan adalah event dalam format JSON, dijelaskan di bawah.
Evd-SignatureWaktu 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
  }
}
KolomDeskripsi
event_idUnik untuk setiap event. Lewati ID yang sudah Anda proses.
typeNama event, dari daftar di akhir halaman ini.
created_atWaktu event terjadi, dalam UTC.
testBernilai true jika event dipicu oleh kunci uji.
dataCatatan 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:

  1. Baca t (waktu Unix dalam detik) dan v1 dari header Evd-Signature.
  2. Hitung HMAC-SHA256 dengan rahasia Anda atas t, sebuah titik, dan isi permintaan mentah persis seperti yang diterima.
  3. Bandingkan hasilnya dengan v1 menggunakan perbandingan waktu konstan.
  4. Tolak permintaan jika t berselisih lebih dari lima menit dari jam Anda.
  5. 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.

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

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.

EventDeskripsi
product.createdProduk ditambahkan.
product.updatedDetail produk berubah.
item.createdNomor seri atau lot ditambahkan ke produk.
item.updatedNomor seri atau lot berubah.
item.publishedPaspor nomor seri atau lot sudah tayang.
item.withdrawnNomor seri atau lot ditarik.
compliance.createdSertifikat atau catatan kepatuhan ditambahkan.
compliance.updatedCatatan kepatuhan berubah.
document.uploadedDokumen diunggah.
extraction.completedEkstraksi data dari dokumen selesai.
review.requiredAda perubahan yang menunggu tinjauan.
review.approvedPeninjau menyetujui perubahan.
review.rejectedPeninjau menolak perubahan.
passport.publishedPaspor produk diterbitkan.
passport.withdrawnPaspor produk ditarik.
certificate.expiringSertifikat akan kedaluwarsa dalam 30 hari.
certificate.expiredSertifikat sudah kedaluwarsa.