Dokumentasi Developer

Idempotensi

Setiap penulisan /v1 bersifat idempoten sehingga percobaan ulang di jaringan tidak pernah menggandakan data.

Cara kerjanya

Sertakan header Idempotency-Key pada setiap penulisan. Lyra mencatat pasangan (kunci, idempotency-key) beserta hasil pertamanya, lalu memutar ulang hasil itu pada percobaan berikutnya dengan idempotency-key yang sama.

Metode tulis @lyraform/sdk melampirkan dan memakai ulang otomatis header Idempotency-Key

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

Aturan

Putar ulang mengembalikan hasil pertama

Permintaan kedua dengan idempotency-key yang sama mengembalikan hasil pertama yang tersimpan tanpa menjalankan penulisan lagi.

Header wajib pada penulisan

Penulisan tanpa header Idempotency-Key ditolak dengan status 400 sebelum handler berjalan.

Penyimpanan tak terjangkau ditolak

Jika penyimpanan idempotensi tidak terjangkau, permintaan ditolak dengan status 503 daripada mengambil risiko penulisan ganda.