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,
      providerId: req.body.providerId,
      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 });
  }
});

// Create a virtual meeting link
const { url, platform } = await sdk.createMeeting({
  tenantId: 'tenant_123',
  providerId: 'provider_123',
  subject: 'Consultation',
  start: '2024-01-16T10:00:00Z',
  end: '2024-01-16T11:00:00Z'
});
// platform: 'google' | 'microsoft'
// url: meeting join link

// 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');
});