API Про окна

Через API можно читать и менять всё, что есть в кабинете: брони, услуги, специалистов, график, клиентов, деньги. Формат запросов и ответов: JSON:API 1.1.

Адрес

https://ваш-адрес.windowsdo.ru/api/v1/{раздел}

У каждого кабинета свой адрес: вместо «ваш-адрес» подставьте адрес своего кабинета.

Первый запрос

curl https://ваш-адрес.windowsdo.ru/api/v1/bk-bookings?page[size]=5 \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"

Ключ и вход

Ключ создаёт владелец кабинета: меню → «Настройки» → «API и webhooks». У ключа есть роль: он видит и меняет только те разделы, которые открыты этой роли. Ключ показывается один раз при создании.

Ключ передаётся в каждом запросе заголовком:

Authorization: Bearer ВАШ_КЛЮЧ

API доступен на платных тарифах.

Формат запросов

Тело запроса и ответ в JSON. У каждой записи есть type (раздел), id и attributes (поля).

{
  "data": {
    "type": "bk-bookings",
    "id": "15",
    "attributes": { "...": "..." }
  }
}

Для POST, PATCH и DELETE нужен заголовок Content-Type: application/json.

Списки: отбор, сортировка, страницы

GET https://ваш-адрес.windowsdo.ru/api/v1/bk-bookings?filter[status]=confirmed&sort=-id&page[size]=50

В ответе data (записи) и meta: total (сколько всего), size (размер страницы).

Создание и изменение

В attributes передаются только те поля, которые меняются. Поля со звёздочкой обязательны при создании. Поля «только чтение» сервер заполняет сам.

curl -X PATCH https://ваш-адрес.windowsdo.ru/api/v1/buyers/42 \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"data":{"type":"buyers","id":"42","attributes":{"name":"Новое имя"}}}'

Ошибки

{ "errors": [ { "status": "422", "code": "validation", "detail": "Текст для человека" } ] }

Деньги, даты, телефоны

• Деньги передаются в копейках целым числом: 1 500 ₽ это 150000.
• Дата: 2026-10-12. Дата и время: 2026-10-12 10:30:00.
• Телефон: с плюсом и кодом страны, +79270001122.

Webhooks

Webhook сообщает вашему серверу о событиях в кабинете. Настраивается там же, где ключи: адрес (только https) и список событий.

Событие записывается как раздел.действие: bk-bookings.create, buyers.update. Все события раздела: bk-bookings.*. Все события: *.

Запрос приходит методом POST. Заголовки: X-Agrodo-Event (событие) и X-Agrodo-Signature: sha256=… (HMAC-SHA256 тела запроса с секретом webhook). Проверяйте подпись перед обработкой.

{
  "id": "9f2c1a7b3d4e5f60",
  "event": "bk-bookings.create",
  "created_at": "2026-10-12T07:30:00+00:00",
  "data": { "type": "bk-bookings", "id": "15", "changes": { "...": "..." } }
}

Кроме событий разделов (create, update, delete) есть события по смыслу:

Если ваш сервер не ответил кодом 2xx, доставка повторяется.

Как создать бронь

1. Возьмите номер услуги, жилья или экскурсии из разделов услуг, жилья, экскурсий.
2. Узнайте свободное время.
3. Создайте бронь. Сервер сам проверит, что время свободно, и посчитает сумму.

Свободное время

GET https://ваш-адрес.windowsdo.ru/api/v1/booking/availability?object_id=10&date=2026-10-12

{ "mode": "slots", "date": "2026-10-12",
  "slots": [ { "time": "10:00", "resources": [3, 4] }, { "time": "10:30", "resources": [3] } ] }

Брони

Создание

curl -X POST https://ваш-адрес.windowsdo.ru/api/v1/booking/bookings \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"object_id":10,"resource_id":3,"date":"2026-10-12","time":"10:30",
       "guest":{"name":"Клиент","phone":"+79270001122"}}'

Состояния

new ждёт подтверждения, hold ждёт оплаты, confirmed подтверждена, done состоялась, noshow не пришли, cancelled отменена.

POST /booking/bookings/15/status   { "status": "done" }
POST /booking/bookings/15/pay      { "amount": 150000, "money_account_id": 1 }
POST /booking/bookings/15/items    { "kind": "service", "object_id": 11 }
POST /booking/bookings/15/items    { "kind": "product", "product_id": 7, "qty": 1 }

Список броней с отбором и сортировкой берётся из раздела bk-bookings.

График специалистов

PUT /booking/schedule
{ "resource_ids": [3], "days": ["2026-10-12", "2026-10-13"],
  "mode": "work", "hours": "09:00-13:00, 14:00-18:00", "branch_id": 1 }

mode: work часы, off выходной, clear убрать запись. Промежуток между отрезками часов это перерыв. Без филиалов branch_id не передаётся.

Заявки requests

Выезды visits

Заказы на заводе dl-orders

Рекламации dl-claims

Расчёты окон wc-calcs

Записи клиентов bk-bookings

Услуги для записи bk-services

Страница записи bk-forms

Мои юрлица dl-legal

Баланс у завода dl-balances

Счета dl-invoices

Клиенты buyers

Задачи tasks

Пользователи users

Роли roles

Дополнительные поля custom-fields

Причины решений по рекламациям dl-claim-reasons

Воронки заявок request-funnels

Быстрые ответы quick-replies

Рассылки mailings

Группы клиентов counterparty-groups

Оповещения notification-rules

Журнал сообщений outbox

Выгрузка на Авито avito-feeds