कस्टम बुकिंग UI
अपने उत्पाद में उपलब्ध समय दिखाएं और backend से booking भेजें।
Tenant API Key कभी browser code में न रखें।
डेवलपर्स के लिए
अपने उत्पाद में scheduling जोड़ें।
Slotkit server-side API से उपलब्ध समय पूछें, booking बनाएं और signed Webhook पाएं।
API-only इस्तेमाल में भी Slotkit व्यस्त समय के लिए Google Calendar जांचता और Booking event लिखता है।
एकीकरण के तरीके
Slotkit Hosted Booking पेज और versioned server-side API के माध्यम से समान scheduling क्षमता देता है। ये एक ही उत्पाद के दो प्रवेश मार्ग हैं।
मौजूदा एप्लिकेशन
मौजूदा service में booking creation, reschedule और cancellation जोड़ें।
Key scopes, idempotency और concurrency नियम अपनाएं।
बाहरी workflows
अपने सिस्टम को अपडेट करने के लिए lifecycle Webhook लें।
Slotkit सामान्य workflow builder नहीं देता।
Hosted और API
Booking पेज इस्तेमाल करें और जरूरत पर वही configured scheduling resources जोड़ें।
Hosted access rules और API authorization अलग रहते हैं।
न्यूनतम एकीकरण प्रवाह
- 01
उपलब्ध समय पूछें
किसी समय पर Event Type के लिए bookable Slot पूछें।
- 02
चुनी हुई booking बनाएं
Unique idempotency key और मेहमान विवरण के साथ Slot भेजें।
- 03
lifecycle event संसाधित करें
Signed Booking और Calendar lifecycle Webhook पाएं।
दिखाया गया Slot hold नहीं होता। create call confirm होने से पहले अनुपलब्ध हो सकता है; conflict response संभालें।
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" }
}उसी response में Booking confirmed है और Calendar event pending बताया जाता है। Booking confirmation Calendar event लिखे जाने का इंतजार नहीं करती।
API में शामिल सुविधाएं
- Fixed scopes वाले versioned /v1 REST contract और server-side API Key।
- Availability query तथा booking creation, reschedule और cancellation।
- Booking Invitation की listing, creation, revocation और reissue।
- Application context के लिए सीमित Metadata, scheduling या authorization semantics के बिना।
- Implemented contract के लिए server-side TypeScript SDK।
- Signed booking.created, booking.rescheduled, booking.cancelled, calendar.created और calendar.failed Webhook।
v1 contract स्थिर है और API reference में उपलब्ध है। TypeScript SDK 1.0.0 पर implemented है लेकिन अभी सार्वजनिक रूप से वितरित नहीं है।
एकीकरण में इन बातों की योजना बनाएं
- सुरक्षित request replay
- Mutation idempotency स्वीकार किए गए retry से दूसरी booking बनने से रोकती है। Conflict और बदले हुए request को संभालना होगा।
- Booking और side effects
- Calendar sync और Webhook delivery committed state का पालन करते हैं। देरी booking को रद्द नहीं करती।
- Availability निर्भरता
- Google Calendar उपलब्ध न हो और वैध हालिया snapshot न हो तो check fail closed हो सकता है।
- समवर्ती booking
- Query और submit के बीच Slot अनुपलब्ध हो सकता है। Integration को response संभालना होगा।
- Delivery model
- Webhook retry हो सकता है और एक से अधिक बार आ सकता है। Signature जांचें और event identity से deduplicate करें।
- Recovery
- Retry सीमित हैं। Failed sync या delivery के लिए authorized recovery action लग सकता है।
Credentials और isolation
- API Key केवल server environment में रखें, browser code में नहीं।
- Scopes fixed और least-privilege हैं; integration जितना इस्तेमाल करे उतना ही मांगें।
- Webhook delivery signed हैं; event पर भरोसा करने से पहले signature जांचें।
- हर workspace केवल अपना data देखता है और cross-workspace access server पर फिर जांचा जाता है।
संसाधन
v1 contract देखने के लिए interactive API reference इस्तेमाल करें या OpenAPI document डाउनलोड करें। TypeScript SDK अभी सार्वजनिक रूप से उपलब्ध नहीं है।
सवाल
Integration से पहले।
क्या Hosted Booking पेज के बिना Slotkit इस्तेमाल कर सकते हैं?
हां। Scoped API key से वही Event Type और Availability server-to-server पढ़े और book किए जा सकते हैं।
API credential कहां होना चाहिए?
केवल server-side। Tenant API Key browser code में कभी न रखें; अपने backend से call करें।
क्या API के लिए Google Calendar जरूरी है?
हां। API-only इस्तेमाल में भी bookability के लिए Google Calendar जरूरी है क्योंकि Availability और Booking event उसी पर निर्भर हैं।
क्या Webhook केवल एक बार आता है?
नहीं। Delivery retry हो सकती है और कई बार आ सकती है। Signature जांचें और event identity से deduplicate करें।
क्या browser सीधे API call कर सकता है?
API Key के साथ नहीं। Custom booking UI अपने backend से submit करे।
क्या API integration के साथ guests Hosted page इस्तेमाल कर सकते हैं?
हां। Hosted access और API authorization अलग हैं, लेकिन scheduling resources समान हैं।