Przejdź do treści
DarhimLabs Developers

DarhimLabs API

Subscribe to all events

Konfiguracja webhook endpointu na wszystkie eventy DarhimLabs.

Subscribe to all events

Konfiguracja webhook endpointu na wszystkie eventy DarhimLabs.

Kiedy tego uzyc

Uzyj tego przepisu, gdy chcesz: Stworzyc endpoint webhook, ktory odbiera pelny event stream z workspace.

Endpoint referencyjny: POST /webhooks/endpoints.

Implementacja

Node.js

import { DarhimLabs } from "@darhimlabs/node";

const client = new DarhimLabs(process.env.DARHIMLABS_API_KEY!);
await client.webhookEndpoints.create({ url: 'https://example.com/dl/webhook', events: ['*'] });

Python

import os
from darhimlabs import DarhimLabs

client = DarhimLabs(api_key=os.environ["DARHIMLABS_API_KEY"])
client.webhook_endpoints.create({'url': 'https://example.com/dl/webhook', 'events': ['*']})

PHP

<?php

$client = new DarhimLabs\Client(["api_key" => $_ENV["DARHIMLABS_API_KEY"]]);
$client->webhookEndpoints->create(['url' => 'https://example.com/dl/webhook', 'events' => ['*']]);

Ruby

client = DarhimLabs::Client.new(api_key: ENV["DARHIMLABS_API_KEY"])
client.webhook_endpoints.create(url: 'https://example.com/dl/webhook', events: ['*'])

Test it

  1. Wykonaj request w sandboxie z kluczem dl_test_....
  2. Sprawdz X-Request-ID w odpowiedzi.
  3. Dla webhookow uzyj Webhook Playground, zeby zobaczyc payload live.

Common pitfalls

  • Dla produkcji preferuj konkretne eventy. * jest wygodne na start, ale halasliwe.
  • Loguj request_id i event_id, zeby support mogl odtworzyc problem.
  • Dla mutacji dodawaj Idempotency-Key, szczegolnie jesli request moze byc retryowany.

Production checklist

  • Dodaj retry z exponential backoff i jitterem.
  • Ogranicz scopes API key do minimalnego zestawu.
  • Monitoruj rate limit headers i latency P95.
  • Przetestuj bledy 401, 409, 422 i 429.

Related