DarhimLabs API
Quickstart - pierwszy API call w 5 minut
Od zera do pierwszej konwersacji, wiadomosci i webhooka w sandbox API DarhimLabs.
Quickstart
Od pustego projektu do pierwszego dzialajacego requestu w 5 minut. Wybierz jezyk, skopiuj kod albo uruchom bezpieczny sandbox snippet.
Wybierz jezyk
Wygeneruj API key
Wejdz do Developer Console, utworz klucz testowy `dl_test_...` i zapisz go w secret managerze. Klucz produkcyjny `dl_live_...` pokazujemy tylko raz.
DARHIMLABS_API_KEY=dl_test_...
Zainstaluj SDK dla Node.js
Oficjalne SDK sa projektowane jako cienka, typed warstwa nad OpenAPI v2.
npm install @darhimlabs/node
Wykonaj pierwszy call
Pobierz otwarte konwersacje z sandbox workspace. Ten krok powinien zamknac time-to-first-API-call w kilku minutach.
import { DarhimLabs } from "@darhimlabs/node";
const client = new DarhimLabs(process.env.DARHIMLABS_API_KEY!);
const conversations = await client.inbox.conversations.list({
status: "open",
limit: 10
});
console.log(`Found ${conversations.data.length} open conversations`);Sandbox wykonuje tylko whitelisted snippet `quickstart-step-3`.
Wyslij wiadomosc
Kazdy write request dostaje `Idempotency-Key`, zeby retry nie zdublowal wiadomosci.
const conversation = conversations.data[0];
const message = await client.inbox.conversations.sendMessage(conversation.id, {
channel: conversation.channel,
content: "Czesc! Czym moge pomoc?"
}, {
idempotencyKey: "msg_quickstart_001"
});
console.log("Sent:", message.id);Sandbox wykonuje tylko whitelisted snippet `quickstart-step-4`.
Subscribe webhooks
Webhook secret zapisz od razu. Do weryfikacji podpisu uzywaj raw body i timing-safe comparison.
const endpoint = await client.webhooks.endpoints.create({
url: "https://your-app.com/webhooks/darhimlabs",
events: ["conversation.created", "message.received"],
secret: "auto"
});
console.log("Webhook secret:", endpoint.secret);Sandbox wykonuje tylko whitelisted snippet `quickstart-step-5`.
Co dalej?
Po pierwszym callu najczesciej developerzy dodaja webhooks, tworza leady z konwersacji i podpina webhook signature verification.