Panduan booking

Buat booking pertama untuk Studio Rapi lewat API dalam beberapa menit. Kamu butuh satu serviceSlug dan header Idempotency-Key.

Langkah 1 — buat booking#

Kirim POST /book/{tenantSlug}/bookings dengan serviceSlug dan waktu mulai dalam UTC epoch milidetik. Termilo mengecek slot di bawah lock lalu menahannya sebagai held.

curl -X POST https://termilo.id/book/{tenantSlug}/bookings \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8b1f4c2e-..." \
-d '{ "serviceSlug": "konsultasi", "startsAtMs": 1751446800000, "source": "public_page", "customer": { "name": "Sari", "primaryEmail": "sari@contoh.id" } }'
Idempotency
Kirim header Idempotency-Key agar retry tidak membuat booking ganda.

Langkah 2 — webhook#

Daftarkan endpoint webhook agar setiap booking.created dan booking.cancelled dikirim ke server kamu. Verifikasi signature sebelum memproses.

Perhatian
Ada batas laju permintaan per API key. Antrekan ulang dengan backoff bila kena 429.
Bahaya
Jangan ekspos secret key di front-end. Semua panggilan tulis harus dari server.

Error & retry#

Termilo memakai kode status HTTP standar. 409 berarti slot sudah terisi — minta ulang ketersediaan, lalu coba slot lain.

Catatan
Semua waktu memakai timezone tenant. Selalu kirim offset eksplisit pada start.

Pertanyaan umum

FAQ

Tidak. Customer cukup pilih layanan & slot, lalu isi nama + WhatsApp. Booking langsung masuk.

Langkah berikutnya#

Pelajari seluruh endpoint dan format response, atau ekspos struktur docs untuk asisten AI.

Dipakai untuk

Diperbarui 12 September 2026