Langsung ke konten
DenganRestu
Mulai Rencanakan

Legal

Dokumentasi API

Terakhir diperbarui: 16 Agustus 2026

Kalau kamu ingin membangun halaman undangan sendiri — dengan desain, domain, dan kode kamu — tapi tetap memakai data yang sudah kamu isi di DenganRestu, halaman ini caranya. Daftar acara, hitung mundur, kisah, foto, sampai status RSVP bisa diambil dari satu alamat. Datanya tetap satu: yang kamu ubah di aplikasi langsung ikut berubah di halamanmu.

Menerbitkan kunci

Buka Undangan Digital → Akses API di aplikasi. Ada dua jenis kunci, dan bedanya penting:

Kunci ditampilkan sekali. Kami hanya menyimpan sidik jarinya, jadi kalau hilang, terbitkan yang baru lalu cabut yang lama. Maksimal 4 kunci publik dan 3 kunci rahasia aktif per akun — cukup untuk berganti kunci tanpa halamanmu mati di tengah pergantian.

Memakainya

Kunci dikirim lewat header, tidak pernah lewat alamat. Alamat tercatat di log dan ikut terkirim ke situs lain lewat header Referer; header tidak.

const r = await fetch(
  "https://www.denganrestu.com/api/v1/undangan/SLUG-UNDANGANMU",
  { headers: { Authorization: "Bearer drpk_xxxxx" } }
);
const { ok, data } = await r.json();
console.log(data.mempelai.label, data.tanggalTampil, data.acara);

SLUG-UNDANGANMU adalah bagian akhir link undanganmu — sama dengan yang ada di denganrestu.com/rsvp/….

Memeriksa kunci

Sebelum menulis kode lain, pastikan kuncimu terbaca: GET /api/v1/ping. Ia menjawab kelas dan izin kuncimu, dan tak menyentuh data apa pun.

Yang dikembalikan

GET /api/v1/undangan/<slug> mengembalikan isi undangan yang sudah terlihat oleh siapa pun yang membuka halaman undanganmu: nama mempelai, tanggal, rangkaian acara, kisah, blok keluarga, foto, video, status RSVP, dan apakah amplop digital menyala.

Yang tidak akan pernah keluar lewat kunci publik: nomor HP tamu, catatan internalmu di rangkaian acara, daftar tamu, catatan amplop, dan nomor rekening pencairan. Batasnya satu kalimat — kunci publik tak membuka apa pun yang belum terbuka di halaman undanganmu.

Daftar alamat

Semua diawali https://www.denganrestu.com/api/v1.

Kunci publik — boleh dipanggil dari halamanmu

Kunci rahasia — hanya dari server sendiri

Mengirim RSVP

Dua langkah, dan langkah pertama tidak bisa dilewati. Ambil kirimanId lebih dulu, lalu kirimkan bersama jawabannya:

const key = { Authorization: "Bearer drpk_xxxxx" };
const base = "https://www.denganrestu.com/api/v1/undangan/SLUG";

const { data } = await (await fetch(base + "/kiriman", { headers: key })).json();

await fetch(base + "/rsvp", {
  method: "POST",
  headers: { ...key, "Content-Type": "application/json" },
  body: JSON.stringify({
    kirimanId: data.kirimanId,
    nama: "Ni Kadek Sari",
    hadir: "ya",          // "ya" | "mungkin" | "tidak"
    dewasa: 2,
    anak: 1,
    ucapan: "Selamat berbahagia!",
  }),
});

Kenapa dua langkah. kirimanId kami yang menerbitkan dan kami yang tandatangani. Kalau tamu menekan kirim dua kali — hal yang biasa terjadi di venue dengan sinyal jelek — kiriman kedua memperbarui baris yang sama alih-alih membuat tamu ganda. Kunci buatanmu sendiri tidak bisa kami verifikasi, jadi header Idempotency-Key kami tolak: menerimanya justru akan menghasilkan baris ganda diam-diam.

Ambil kirimanId baru untuk setiap tamu. Memakai satu kirimanId untuk dua orang berbeda akan menimpa jawaban yang pertama.

Mengubah daftar tamu

PATCH hanya menyentuh field yang kamu KIRIM. Field yang tidak kamu sebut dibiarkan apa adanya — jadi kamu tak perlu mengirim seluruh data tamu hanya untuk mengubah satu hal, dan tak ada yang terhapus karena lupa disertakan. Untuk mengosongkan sebuah field, kirim null secara eksplisit.

// hanya rsvp yang berubah; nama, jumlah, kelompok tetap
await fetch(base + "/tamu/" + id, {
  method: "PATCH",
  headers: { ...key, "Content-Type": "application/json" },
  body: JSON.stringify({ rsvp: "Hadir" }),
});

// kosongkan nomor meja
body: JSON.stringify({ meja: null })

Untuk POST /tamu kamu BOLEH mengirim header Idempotency-Key berisi nilai apa pun yang kamu pilih — berguna saat mengimpor daftar panjang: kalau skripmu putus di tengah dan kamu ulang, baris yang sudah masuk tak akan terbuat dua kali. (Di jalur RSVP dan amplop, header itu justru kami tolak — di sana kuncinya harus kami yang terbitkan supaya bisa diverifikasi.)

Menghapus tamu juga menghapus nomor mejanya di denah dan penandaan acaranya. Tak ada konfirmasi di API — pemanggilnya skrip — jadi pastikan kamu benar-benar bermaksud menghapus.

Mengubah isi undangan

Aturannya sama dengan tamu: hanya field yang kamu kirim yang tersentuh. Yang tak kamu sebut dibiarkan apa adanya, dan null berarti kosongkan. Bedanya, di sini objek bersarang ikut di-merge sampai ke dalam — mengirim satu nama ayah tidak menghapus pihak mempelai yang lain.

const api = "https://www.denganrestu.com/api/v1/undangan";
const key = { Authorization: "Bearer drsk_…", "Content-Type": "application/json" };

// hanya nama ayah pihak pria; salam, kalimat pengundang,
// dan SELURUH pihak wanita tidak tersentuh
await fetch(api, {
  method: "PATCH",
  headers: key,
  body: JSON.stringify({
    keluarga: { groom: { father: "I Wayan Sudira" } },
  }),
});

// beberapa bagian sekaligus
body: JSON.stringify({
  tampilan: { warna: "batu-lumut" },   // gaya & struktur tak disebut → tak berubah
  rsvp:     { batas: "2026-08-20" },
  infoTamu: { dressCode: "Kebaya / safari", parking: null },
})

Responsnya membawa diubah — daftar field yang benar-benar kamu minta ubah, sampai ke tingkat terdalam (keluarga.groom.father, bukan keluarga) — beserta undangan versi terbarunya. Pakai diubah untuk memastikan yang berubah memang yang kamu maksud.

Undangan yang sudah kamu sebar berubah seketika. Tidak ada langkah konfirmasi di API — pemanggilnya skrip. Kalau kamu sedang menyusunnya lewat aplikasi juga, buka Undangan Digital: di sana ada keterangan kapan terakhir diubah lewat API, karena menekan simpan pada sebuah kartu akan menimpa perubahan API pada kartu itu.

Yang tidak bisa diubah dari API

Alamat undangan (slug), status terbit, foto, musik latar, dan sakelar amplop digital sengaja hanya bisa diubah dari aplikasi. Semuanya punya akibat yang harus terlihat sebelum ditekan: mengganti alamat mematikan setiap link personal tamu yang sudah tersebar, menutup undangan mematikan RSVP dan Cari Mejamu sekaligus, dan amplop menyangkut uang. Kalau kamu mengirimnya, kami menolak dengan pesan yang menyebut alasannya — bukan mengabaikannya diam-diam.

Kalau dua orang menulis bersamaan

Ambil versi dari respons GET, lalu sertakan di PATCH berikutnya. Kalau undangan sudah berubah sejak itu, kami menjawab 412 dan tak menulis apa pun — ambil ulang, gabungkan, kirim lagi. Ini opsional; tanpa versi tulisanmu tetap diterapkan di atas keadaan terbaru.

412 berarti jangan diulang begitu saja. 409 berarti sebaliknya: dua penulisan berpapasan dan kamu tak salah apa-apa — kirim ulang badan yang sama. Karena itu jangan menjalankan beberapa PATCH ke satu undangan secara bersamaan; jalankan berurutan.

Mengubah rangkaian acara

Aturan merge-nya sama: hanya field yang kamu kirim yang tersentuh. Ada empat hal yang khas di sini, dan semuanya punya alasan yang sama — acara bukan sekadar baris, ia menyetir apa yang dilihat tamu dan apa yang dihitung aplikasi.

const api = "https://www.denganrestu.com/api/v1/acara";
const key = { Authorization: "Bearer drsk_…", "Content-Type": "application/json" };

// MEMBUAT: tampilDiUndangan WAJIB disebut — tak ada bawaan
await fetch(api, {
  method: "POST", headers: key,
  body: JSON.stringify({
    label: "Mebat", tampilDiUndangan: false,   // prosesi internal, tamu tak melihat
    tanggal: "2026-08-20", jam: "06:00", banjar: "Banjar Tegal",
  }),
});

// MENGUBAH: hanya jam
await fetch(api + "/" + id, { method: "PATCH", headers: key,
  body: JSON.stringify({ jam: "07:30" }) });

// HARI UTAMA: endpoint sendiri, badan kosong
await fetch(api + "/" + id + "/utama", { method: "POST", headers: key });

Menghapus acara

Menghapus satu acara memusnahkan permanen denah kursi acara itu dan tanda “diundang ke acara ini” pada setiap tamu yang ditandai. Pos budget, rundown, tugas panitia, katering, dan pemuput tidakikut terhapus — semuanya jadi “Umum”.

Karena API tak punya dialog konfirmasi, penggantinya adalah pengakuan: permintaan pertama dijawab 409 beserta angka kerusakannya, dan kamu mengulanginya sambil menyebutkan angka itu. Angkanya harus yang terbaru — dihitung ulang tepat saat penghapusan, jadi pengakuan yang kamu tulis mati di skrip akan gagal justru ketika kerusakannya berubah.

// 1) ditolak, tapi kami sebutkan apa yang akan hilang
DELETE /acara/<id>              →  409 { error: { kode: "akibat_belum_diakui", … } }

// 2) ulangi dengan angkanya (tambahkan &akuiUtama=1 bila ia Hari Utama)
DELETE /acara/<id>?akuiKursi=6&akuiTamu=42
→ 200 { dihapus: true, akibat: { kursi: 6, tamu: 42 },
        dilepas: { budget: 3, rundown: 8, panitia: 2, katering: 1, pemuput: 1 } }

Cocokkan acara lewat id, jangan lewat namanya. Skrip sinkron yang menghapus-lalu-membuat-ulang saat sebuah nama berubah akan memusnahkan denah dan penandaan tamunya setiap kali.

Perubahan label atau tanggal tidak menyusul ke berkas kalender yang sudah tersimpan di ponsel tamu, maupun ke kartu WhatsApp yang sudah ter-cache di percakapan mereka.

Amplop digital: membaca, bukan mencairkan

GET /amplop/saldo menjawab tiga angka yang berbeda, dan membedakannya penting:

Nomor rekening tidak pernah dikembalikan API — tidak utuh, tidak pula empat digit terakhirnya — dan begitu juga nama bank, nama pemilik rekening, serta bukti transfer. Cocokkan baris pencairan lewat tanggal dan nominalnya. Nomor lengkapmu ada di halaman Amplop Digital di aplikasi.

Meminta pencairan hanya bisa lewat dasbor, dan itu permanen — bukan “belum ada”. Menentukan ke rekening siapa uang keluarga dikirim adalah keputusan kepemilikan; kami sudah menolak memberikannya kepada kolaborator yang kamu percaya sendiri, dan kunci API hidup lebih lama daripada niat yang menerbitkannya. Pencairannya juga dieksekusi manusia, bukan mesin — jadi antrean permintaan programatik terhadapnya tak akan pernah kami buka.

Kalau ada yang salah

Setiap galat menjawab dengan bentuk yang sama, dan ok: false selalu ada di badan — jadi kamu bisa memeriksanya tanpa melihat kode status:

{ "ok": false, "error": { "kode": "kunci_tak_dikenal", "pesan": "…", "dok": "…" } }

Batas yang perlu kamu tahu

Pertanyaan

Kirim lewat halaman kontak. Sebutkan slug undanganmu dan empat karakter terakhir kunci yang bermasalah — jangan pernah mengirimkan kuncinya sendiri, kepada kami maupun kepada siapa pun.

Baca juga: Syarat & Ketentuan · Kebijakan Privasi