Dokumentasi Developer

Panduan Cepat

Tiga langkah dari kunci baru sampai integrasi yang berjalan dan terverifikasi.

Buat API key

Di workspace Bisnis, buka Integrasi → API Keys lalu buat kunci dengan scope yang Anda butuhkan (mis. forms:write, submissions:write). Kunci mentah hanya ditampilkan sekali — simpan dengan aman.

Pasang SDK dan panggil /v1

Pasang @lyraform/sdk, buat klien dengan kunci Anda, lalu buat form pertama. Metode tulis otomatis melampirkan Idempotency-Key dan mengulang kegagalan sementara.

bash

pnpm add @lyraform/sdk

import { LyraClient, LyraApiError, verifyWebhook } from "@lyraform/sdk";

const lyra = new LyraClient({ apiKey: process.env.LYRA_API_KEY! });

const form = await lyra.forms.create({
  title: "Pendaftaran Workshop",
  description: "Form pendaftaran peserta workshop.",
});
// form.id → "frm_…"  (a draft, stamped to your workspace)

Terima webhook

Daftarkan endpoint HTTPS, lalu verifikasi setiap kiriman terhadap body mentah dengan verifyWebhook sebelum mempercayai payload. Balas dengan 2xx untuk memberi tanda terima.

import { LyraClient, LyraApiError, verifyWebhook } from "@lyraform/sdk";

// In your webhook handler — verify BEFORE trusting the payload.
const valid = await verifyWebhook(rawBody, signatureHeader, signingSecret);
if (!valid) return new Response("bad signature", { status: 401 });