Webhooks saņemties autorei aktuālos notikumus

Nedaudz vairāk

Visas lietas ir līdzīgas JSON top-level formātā: `event`, `envelope_id`, `occurred_at`, `data`.

{
  "event": "envelope.completed",
  "envelope_id": "env_01HG3K8X9Y2N4P5Q6R7S8T9V0W",
  "occurred_at": "2026-05-27T08:42:13.521Z",
  "data": {
    "title": "Contrat de prestation Acme Corp",
    "status": "completed",
    "created_at": "2026-05-24T14:12:00.000Z",
    "completed_at": "2026-05-27T08:42:13.000Z",
    "signers": [
      {
        "email": "client@acme.example",
        "name": "Alex Client",
        "signed_at": "2026-05-27T08:42:13.000Z",
        "method": "eidas_aes",
        "ip": "203.0.113.42"
      }
    ],
    "proof_pdf_url": "https://certyneo.com/api/envelopes/env_01HG.../proof.pdf"
  }
}

HMAC signātu aprēķina uz brūnajiem korpusa datiem, kā nosūtīts.

Pārbaudiet HMAC parakstu

Katru pieprasījumu paraksta ar jūsu webhook noslēpumu (izskatāms tikai vienu reizi, kad izveidojiet to, un pēc tam kodēts, kad esat atstājuši).<timestamp>,v1=<hex_hmac>Vispirms pārbaudiet parakstu, pirms apstrādājat slodzi. Bez šī posma ikviens var izdomāt notikumu un izsaukt jūsu galamērķi.

import crypto from "node:crypto";

export function verifyCertyneoSignature(
  rawBody: string,
  signatureHeader: string,
  secret: string,
): boolean {
  // Header format: t=<timestamp>,v1=<hex_hmac>
  const parts = Object.fromEntries(
    signatureHeader.split(",").map((p) => p.split("=")),
  );
  const ts = parts.t;
  const sig = parts.v1;
  if (!ts || !sig) return false;

  // Reject events older than 5 minutes (replay protection).
  const age = Math.abs(Date.now() / 1000 - Number(ts));
  if (age > 300) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${ts}.${rawBody}`)
    .digest("hex");

  // timingSafeEqual to mitigate timing attacks.
  return crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(sig, "hex"),
  );
}

import hashlib
import hmac
import time


def verify_certyneo_signature(
    raw_body: bytes, signature_header: str, secret: str
) -> bool:
    """Verify a Certyneo webhook signature.

    Header format: `t=<timestamp>,v1=<hex_hmac>`
    Rejects events older than 5 minutes (replay protection).
    """
    parts = dict(p.split("=") for p in signature_header.split(","))
    ts = parts.get("t")
    sig = parts.get("v1")
    if not ts or not sig:
        return False

    if abs(time.time() - int(ts)) > 300:
        return False

    expected = hmac.new(
        secret.encode("utf-8"),
        f"{ts}.{raw_body.decode('utf-8')}".encode("utf-8"),
        hashlib.sha256,
    ).hexdigest()

    return hmac.compare_digest(expected, sig)

Atjaunināšanas politika

Ja jūsu galamērķis atbild uz kaut ko citu, nevis HTTP 2xx (timeout, 5xx, connection refused), mēs izsakām pēc eksponenciālā back-off. Kopumā 6 mēģinājumi ~9 stundās. Pēc 6 notikums tiek atzīmēts kā `failed` jūsu webhook vadības pulkstenī un tiek nosūtīts brīdinājuma e-pasts.

Ja vēlaties manuāli pārsūtīt neizdotos notikumus, webhook vadības pults piedāvā Atdodiet uz katru neizdoto piegādi 7 dienas pēc galīgās neizdodas.

Testēšana bez īsta aploksnes nosūtīšanas

Vislabāk ir izmantot šo metodi, lai pārbaudītu, vai jūsu lietotājs ir izpildījis visus nepieciešamos nosacījumus.

# Trigger a test webhook to your endpoint
curl -X POST https://api.certyneo.com/v1/webhooks/test \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event": "envelope.completed", "url": "https://your.app/webhooks/certyneo"}'

Lai sasniegtu vēl lielāku mērķi

• Izstrādātājs Hub
• E-pirkuma API
• Iedzīvotāju integrācija
• Drošības lapas
• Plāni un tarifi