Skip to content
LinkdashLinkdash
Lietuvių
Esc
↑↓navigate↵open⌘Jpreview
On this page

Webhook'ai

HTTPS galutiniai taškai link.visit, link.download ir link.play, pristatomi per Svix.

HTTPS galutiniai taškai. Tik HTTPS. Be localhost ar privačių IP adresų. Iki 10 vienai paskyrai.

Įvykiai: link.visit, link.download, link.play. Paslaptis yra whsec_…, rodoma tik vieną kartą sukūrimo ar rotavimo metu. Išsaugokite ją. Niekada neįdėkite jos į JSON turinį.

CLI

linkdash webhooks create --url https://example.com/hooks
linkdash webhooks list
linkdash webhooks get <id>
linkdash webhooks rotate <id>
linkdash webhooks delete <id>

list ir get grąžina tik secretHint (whsec_…xxxx).

HTTP

curl https://api.linkdash.dev/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer ldash_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks"}'

GET /webhooks, POST /webhooks, GET /webhooks/:id, DELETE /webhooks/:id, POST /webhooks/:id/rotate.

Turinys

{
  "type": "link.visit",
  "timestamp": "2026-08-17T16:00:00.000Z",
  "data": { "id": "deck", "kind": "file", "variant": "main", "country": "DE", "referrer": "…" }
}

data.variant yra variantas, kurį gavo lankytojas (main vienvariantėms nuorodoms).

Antraštės kiekviename pristatymе (Svix pakartotinai bandymai naudoja tą patį id):

  • svix-id
  • svix-timestamp (unix sekundėmis)
  • svix-signature (v1,<base64 hmac>)

Pasirašomas turinys: {id}.{timestamp}.{raw body} HMAC-SHA256. Paslapties formatas whsec_ + base64.

Patikrinimas

Pristatymus siunčia Svix ir jie atitinka Standard Webhooks specifikaciją. Patikrinkite naudodami svix paketą (tas pats, kurį naudoja Clerk ir Resend).

npm i svix
import { Webhook, WebhookVerificationError } from "svix";

const wh = new Webhook(process.env.LINKDASH_WEBHOOK_SECRET); // whsec_… rodoma tik vieną kartą

try {
  const event = wh.verify(rawBody, {
    "svix-id": headers["svix-id"],
    "svix-timestamp": headers["svix-timestamp"],
    "svix-signature": headers["svix-signature"],
  });
  // event.type yra "link.visit" | "link.download" | "link.play"
} catch (err) {
  if (err instanceof WebhookVerificationError) {
    // 400 — neapdorokite
  }
  throw err;
}

Was this page helpful?