ZvenBook API Documentation

import { createSdk } from '@zvenbook/sdk';
import { useState, useEffect } from 'react';

const sdk = createSdk({ baseUrl: process.env.NEXT_PUBLIC_ZVENBOOK_URL });

export default function BookingWidget({ tenantId, serviceId }) {
  const [slots, setSlots] = useState([]);
  const [providers, setProviders] = useState([]);
  
  useEffect(() => {
    async function loadData() {
      const { providers } = await sdk.listProviders({ tenantId });
      setProviders(providers);
      
      if (providers.length > 0) {
        const { slots } = await sdk.availability({
          tenantId, serviceId, providerId: providers[0]._id,
          start: new Date().toISOString(),
          end: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
          timezone: 'Europe/Stockholm'
        });
        setSlots(slots);
      }
    }
    loadData();
  }, [tenantId, serviceId]);

  const bookSlot = async (slot) => {
    await sdk.createBooking({
      tenantId, serviceId, providerId: providers[0]._id,
      start: slot.start, end: slot.end,
      contactEmail: 'customer@example.com',
      contactFirstName: 'John', contactLastName: 'Doe'
    });
  };

  return (
    <div className="space-y-2">
      {slots.map(slot => (
        <button key={slot.start} onClick={() => bookSlot(slot)}
                className="p-2 bg-blue-500 text-white rounded">
          {new Date(slot.start).toLocaleString()}
        </button>
      ))}
    </div>
  );
}

const { createSdk } = require('@zvenbook/sdk');
const express = require('express');

const sdk = createSdk({ baseUrl: process.env.ZVENBOOK_URL });
const app = express();
app.use(express.json());

app.post('/book-appointment', async (req, res) => {
  try {
    const booking = await sdk.createBooking({
      tenantId: req.body.tenantId,
      serviceId: req.body.serviceId,
      autoSelectProvider: true, // Auto-select optimal provider
      start: req.body.start,
      end: req.body.end,
      contactEmail: req.body.email,
      contactFirstName: req.body.firstName,
      contactLastName: req.body.lastName
    });
    
    res.json({ success: true, booking });
  } catch (error) {
    res.status(400).json({ error: error.message });
  }
});

// Virtual meetings with auto-generated Jitsi rooms
const booking = await sdk.createBooking({
  // ... other fields
  virtualMeetingPlatform: 'jitsi', // Auto-generates meeting room
  notes: 'First time customer - please call if needed'
});

// Multi-location support
const booking = await sdk.createBooking({
  // ... other fields
  locationName: 'Downtown Office',
  locationAddress: '123 Main St, Stockholm',
  entryPinCode: '1234',
  entryInstructions: 'Use side entrance after hours'
});

// Provider workload analytics
const { providers } = await sdk.getProviderWorkload({
  tenantId: 'salon-123',
  start: '2024-01-01T00:00:00Z',
  end: '2024-01-31T23:59:59Z'
});

providers.forEach(provider => {
  console.log(`${provider.name}: ${provider.booking_count} bookings`);
});