Швидкий старт

Zapys24 API дозволяє вбудувати онлайн-бронювання у ваш сайт, мобільний додаток або CRM. Ваші клієнти зможуть переглядати послуги, обирати вільний час та записуватись — і все це через ваш власний інтерфейс.

Що можна зробити з API

• Показати послуги та майстрів на вашому сайті
• Отримати вільні слоти для конкретної послуги та дати
• Створити бронювання від імені клієнта
• Скасувати запис через ваш інтерфейс
• Отримувати сповіщення про нові записи, скасування та інші події через вебхуки

Крок 1: Отримайте API-ключ

1. Увійдіть у панель керування Zapys24
2. Перейдіть до Налаштування → API-інтеграція
3. Натисніть «Створити API-ключ»
4. Оберіть потрібні дозволи (scopes) — наприклад, services:read, slots:read, bookings:write
5. Скопіюйте ключ — він показується лише один раз!

Збережіть ключ!

API-ключ відображається тільки при створенні. Якщо ви його загубите — потрібно буде згенерувати новий.

Крок 2: Зробіть перший запит

Перевірте, що ключ працює — отримайте список ваших послуг:

curl -H "X-API-Key: ВАШ_КЛЮЧ" \
  https://api.zapys24.com/v1/integration/services

Відповідь (якщо все ок):

[
  {
    "id": 1,
    "name": "Стрижка чоловіча",
    "duration": 60,
    "price": 50000,
    "category": "Перукарські послуги",
    "isOnline": true
  }
]

Ціни

Поле price зберігається у копійках. Щоб отримати суму у гривнях — розділіть на 100. Наприклад, 50000 = 500,00 ₴.

Крок 3: Покажіть вільні слоти

Отримайте вільний час для конкретної послуги:

curl -H "X-API-Key: ВАШ_КЛЮЧ" \
  "https://api.zapys24.com/v1/integration/slots?serviceId=1&date=2026-03-15"

Крок 4: Створіть бронювання

Коли клієнт обрав час — створіть запис:

curl -X POST \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceId": 1,
    "date": "2026-03-15",
    "time": "14:00",
    "phone": "+380991234567",
    "firstName": "Олена"
  }' \
  https://api.zapys24.com/v1/integration/bookings

Готово! Запис з'явиться у вашій панелі Zapys24.

Що далі?

Тема	Опис
Аутентифікація	Як передавати API-ключ, дозволи (scopes), ліміти запитів
Записи → Створення	Повний формат створення бронювання з усіма параметрами
Записи → Послуги, слоти, майстри	Отримання послуг, співробітників, вільних слотів, відгуків
Вебхуки	Налаштування push-сповіщень про події
Помилки	Коди помилок та як їх обробляти
SDK та приклади	Готові TypeScript-типи та приклад API-клієнта