Evimarko API для программистов
Подключите сайт, форму, бота или бухгалтерию к Evimarko: читайте услуги, клиентов и записи, записывайте на свободное время и получайте событие, как только в студии что-то произошло.
Начать за 3 шага
1
Получите ключ
Владелец студии открывает Настройки → Интеграции → Для программистов и нажимает «Создать ключ». Ключ показываем один раз — скопируйте его.
2
Сделайте первый запрос
Передайте ключ в заголовке Authorization. GET /me ответит, какой студии принадлежит ключ.
3
Подпишитесь на события
Дайте нам свой https-адрес в POST /webhooks — новые записи и смены статуса будут приходить на него сами.
curl https://evimarko.com/api/v1/me \
-H "Authorization: Bearer dos_YOUR_KEY"
Ключ, права и лимиты
Каждый запрос несёт ключ в заголовке «Authorization: Bearer dos_…». Один ключ работает только для одной студии и никогда не видит другую. Владелец может отозвать ключ в любой момент.
- «Только смотреть» — читать данные и подписываться на события.
- «Смотреть и добавлять» — ещё и создавать клиентов и записи.
Лимиты: 120 запросов в минуту на ключ и 30 в минуту на создание клиентов, записей и вебхуков. Сверх лимита — ответ 429 с заголовком Retry-After.
Что умеет API
Все запросы и ответы — JSON. Базовый адрес: https://evimarko.com/api/v1
Спецификация OpenAPI 3.1 (JSON) →
Студия
| GET | /me | The studio of the key (also the way to test a key) |
Услуги
| GET | /services | List services |
| GET | /services/{id} | Get a service |
Клиенты
| GET | /clients | List clients or find one by phone |
| POST | /clients | Create a client |
| GET | /clients/{id} | Get a client |
Авто
| GET | /clients/{id}/vehicles | Cars of a client |
| GET | /vehicles | List cars |
| GET | /vehicles/{id} | Get a car |
Записи и заказы
| GET | /orders | List bookings and orders |
| GET | /orders/{id} | Get a booking or order (its status) |
| GET | /slots | Free times of a day |
| POST | /bookings | Book a free time |
Вебхуки
| GET | /webhooks | List webhooks |
| POST | /webhooks | Subscribe to events (REST hook) |
| DELETE | /webhooks/{id} | Unsubscribe |
Бухгалтерия (только чтение)
| GET | /payments | List payments |
| GET | /payments/{id} | Get a payment |
| GET | /materials | List materials |
| GET | /materials/{id} | Get a material |
| GET | /stock-movements | List stock movements |
| GET | /stock-movements/{id} | Get a stock movement |
| GET | /expenses | List expenses |
| GET | /expenses/{id} | Get an expense |
Список запросов — на английском, как в коде.
Записать на свободное время
Запись через API работает по тем же правилам, что и страница онлайн-записи студии: только свободное время и только услуги, которые студия открыла для онлайн-записи.
# 1. Свободное время на день
curl "https://evimarko.com/api/v1/slots?date=2026-11-21&services=12" \
-H "Authorization: Bearer dos_YOUR_KEY"
# → {"date":"2026-11-21","timezone":"Europe/Sofia","duration_minutes":120,"slots":["10:00","12:00","14:00"]}
# 2. Записать на одно из них
curl -X POST https://evimarko.com/api/v1/bookings \
-H "Authorization: Bearer dos_YOUR_KEY" -H "Content-Type: application/json" \
-d '{"services":[12],"date":"2026-11-21","time":"10:00","name":"Maria","phone":"+359 88 123 4567","make":"Kia","model":"Sportage"}'
# → 201 {"data":{"id":345,"number":118,"status":"scheduled","starts_at":"…","client_url":"…"},"client_created":true,"deposit_url":null}
- Время — по часам студии (см. «timezone» в GET /me). Вместо даты и времени можно передать «starts_at» с часовым поясом.
- Знакомый номер телефона — запишем существующего клиента; новый — создадим клиента.
- Если время только что заняли, ответ 422 — запросите свободное время ещё раз.
- Сотрудники получат обычное уведомление о записи, клиент — обычное подтверждение.
Вебхуки: события сразу
На каждое выбранное событие мы отправляем POST с JSON на ваш адрес. Так работают триггеры в Zapier, Make, n8n и Pipedream.
curl -X POST https://evimarko.com/api/v1/webhooks \
-H "Authorization: Bearer dos_YOUR_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/evimarko","events":["booking.created","order.ready"]}'
# → 201 {"data":{"id":7,"url":"…","events":[…],"secret":"…"}}
| booking.created | Новая запись — со страницы записи, из бота, API или CRM |
| order.status_changed | Сменился статус заказа (с прежним статусом) |
| order.ready | Авто готово |
| order.delivered | Заказ выдан клиенту |
| payment.created | Внесена оплата |
| material.purchased | Закупка материала |
| expense.created | Расход |
| client.created | Новый клиент |
Проверьте, что событие от нас
У каждой отправки есть заголовок X-Evimarko-Signature: «sha256=» и HMAC-SHA256 от тела запроса с секретом, который вы получили при подписке. Сравните его, прежде чем доверять данным.
// Node.js
const crypto = require('crypto');
function isFromEvimarko(rawBody, header, secret) {
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
return header.length === expected.length && crypto.timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}
// PHP
$ok = hash_equals('sha256=' . hash_hmac('sha256', $rawBody, $secret), $_SERVER['HTTP_X_EVIMARKO_SIGNATURE'] ?? '');
- Отвечайте 2xx за 10 секунд. Иначе повторим через 1, 5 и 30 минут, потом через 2 и 6 часов.
- «id» отправки при повторе тот же — по нему отсеивайте дубли.
- Ответ «410 Gone» отписывает сразу. После 30 неудачных отправок подряд вебхук выключаем; владелец может включить его снова в Настройках.
- Принимаем только публичные https-адреса. Локальные и внутренние адреса отклоняем.
Ошибки
Ошибка — всегда JSON: {"message": "…"}; для 422 есть ещё «errors» с сообщениями по полям.
| 401 | Нет ключа, ключ неверный или отозван. |
| 402 | API не входит в тариф студии. |
| 403 | У студии нет доступа, или ключ «только смотреть» пытается что-то создать. |
| 404 | Такой записи в этой студии нет. |
| 422 | Данные не прошли проверку, или время занято. |
| 429 | Слишком много запросов. Подождите столько секунд, сколько указано в Retry-After. |
Готовые приложения
Без кода: соедините Evimarko с тысячами других сервисов в сервисе автоматизации.
Zapier
СкороТриггеры: новая запись, смена статуса, авто готово, заказ выдан, новый клиент. Действия: создать клиента, создать запись, найти клиента, найти свободное время.
Make
СкороМгновенные триггеры на события студии и модули для клиентов, услуг, свободного времени, записей и заказов.
n8n
СкороУзел сообщества n8n-nodes-evimarko: узел Evimarko с действиями и Evimarko Trigger на вебхуках.
Pipedream
СкороИсточники событий студии и действия для клиентов и записей.
Чего API никогда не делает
- Не принимает оплаты и не двигает деньги.
- Ничего не удаляет в студии: ни клиентов, ни авто, ни заказы.
- Не даёт доступа к другой студии — ключ принадлежит одной студии.
- Мы храним только отпечаток ключа, а не сам ключ. Потеряли — создайте новый и отзовите старый.
Нужна помощь?
Напишите нам — поможем подключить. Telegram
Ещё нет аккаунта Evimarko? Попробуйте CRM бесплатно и создайте ключ API за две минуты.