UI tempahan tersuai
Paparkan masa tersedia dalam produk dan hantar tempahan melalui backend.
Jangan letakkan Tenant API Key dalam kod pelayar.
Untuk Pembangun
Tambah scheduling ke produk anda.
Tanya masa tersedia, cipta tempahan dan terima Webhook bertandatangan melalui API sisi pelayan Slotkit.
Walaupun menggunakan API sahaja, Slotkit menyemak Google Calendar dan menulis acara tempahan.
Cara mengintegrasi
Slotkit mendedahkan keupayaan scheduling yang sama melalui halaman Hosted Booking dan API sisi pelayan berversi. Dua pintu masuk kepada satu produk.
Aplikasi sedia ada
Tambah penciptaan, penjadualan semula dan pembatalan tempahan.
Ikut keperluan key scopes, idempotency dan concurrency.
Aliran kerja luaran
Terima Webhook lifecycle untuk mengemas kini sistem sendiri.
Slotkit tidak menyediakan pembina aliran kerja umum.
Hosted dan API
Gunakan halaman tempahan dan integrasikan sumber scheduling sama apabila berguna.
Peraturan Hosted access dan API authorization kekal berasingan.
Aliran integrasi minimum
- 01
Tanya masa tersedia
Minta Slot yang boleh ditempah untuk Event Type pada satu masa.
- 02
Cipta tempahan terpilih
Hantar Slot dengan idempotency key unik dan maklumat tetamu.
- 03
Proses event lifecycle
Terima Webhook lifecycle Booking dan Calendar bertandatangan.
Slot yang dipaparkan tidak dipegang. Ia boleh menjadi tidak tersedia sebelum create call mengesahkan; kendalikan respons konflik itu.
POST /v1/bookings
Authorization: Bearer sk_live_2f81c4…
Idempotency-Key: 0f4a9d12-6c33-4b7e-9a10-8ee2c5d17b40
{
"event_type_id": "evt_3n8xqk2r",
"start_at": "2026-09-14T02:00:00.000Z",
"guest": {
"name": "Mei Lin",
"email": "[email protected]",
"timezone": "Asia/Taipei"
}
}201 Created
{
"data": {
"id": "bkg_7pd4m1vs",
"status": "confirmed",
"version": 1,
"source": "api",
"start_at": "2026-09-14T02:00:00.000Z",
"end_at": "2026-09-14T02:30:00.000Z",
"calendar": { "status": "pending", "error_code": null },
"meeting": { "type": "google_meet", "join_url": null }
},
"meta": { "request_id": "req_a71c9f04" }
}Booking ialah confirmed dalam respons yang sama yang melaporkan Calendar event sebagai pending. Pengesahan tidak menunggu Calendar event ditulis.
Kandungan permukaan API
- REST contract /v1 berversi dan API key sisi pelayan dengan scope tetap.
- Pertanyaan Availability serta penciptaan, penjadualan semula dan pembatalan tempahan.
- Senarai, cipta, batalkan dan terbit semula Booking Invitation.
- Metadata terhad untuk konteks aplikasi tanpa semantik scheduling atau authorization.
- TypeScript SDK sisi pelayan untuk contract dilaksanakan.
- Webhook bertandatangan booking.created, booking.rescheduled, booking.cancelled, calendar.created dan calendar.failed.
v1 contract stabil dan tersedia melalui API reference. TypeScript SDK dilaksanakan pada 1.0.0 tetapi belum diedarkan secara umum.
Perkara yang perlu dirancang
- Ulangan request selamat
- Mutation idempotency mencegah retry diterima mencipta tempahan lain. Conflict dan request berbeza masih perlu dikendalikan.
- Booking dan kesan sampingan
- Penyegerakan Calendar dan penghantaran Webhook mengikuti keadaan committed. Kelewatan tidak membatalkan Booking.
- Kebergantungan Availability
- Pemeriksaan boleh fail closed apabila Google Calendar tidak tersedia dan tiada snapshot terkini yang sah.
- Tempahan serentak
- Slot boleh menjadi tidak tersedia antara pertanyaan dan penghantaran. Integrasi mesti mengendalikan response itu.
- Model penghantaran
- Webhook boleh dicuba semula dan tiba berkali-kali. Sahkan tandatangan dan deduplicate dengan event identity.
- Pemulihan
- Retry terhad. Kegagalan sync atau penghantaran mungkin memerlukan tindakan pemulihan berautoriti.
Kelayakan dan pengasingan
- API key hanya dalam persekitaran pelayan, bukan kod pelayar.
- Scope tetap dan least-privilege; minta hanya yang digunakan integrasi.
- Penghantaran Webhook bertandatangan; sahkan sebelum mempercayai event.
- Setiap workspace melihat datanya sendiri dan akses silang disemak semula di pelayan.
Sumber
Gunakan API reference interaktif atau muat turun OpenAPI untuk menilai v1 contract. TypeScript SDK belum tersedia untuk edaran umum.
Soalan
Sebelum anda mengintegrasikan.
Boleh guna tanpa halaman Hosted Booking?
Ya. Event Type dan Availability yang sama boleh dibaca dan ditempah antara pelayan dengan API key berscope.
Di mana kelayakan API perlu berada?
Di pelayan sahaja. Jangan tanam Tenant API key dalam kod pelayar; gunakan backend sendiri.
Adakah API masih memerlukan Google Calendar?
Ya. Availability dan booking events bergantung pada Google Calendar walaupun API sahaja digunakan.
Adakah Webhook dihantar sekali sahaja?
Tidak. Penghantaran boleh diulang dan tiba lebih sekali. Sahkan tandatangan dan deduplicate dengan event identity.
Bolehkah pelayar memanggil API terus?
Bukan dengan API key. UI tersuai perlu melalui backend aplikasi yang menyimpan kelayakan.
Bolehkah tetamu guna Hosted ketika integrasi guna API?
Ya. Hosted access dan API authorization berbeza tetapi menggunakan sumber scheduling sama.