К содержимому
G2 Capterra Trustpilot
Попробовать бесплатноПопробовать
Возможности
Для кого
Цены
Калькуляторы
Ресурсы
Партнёрам
Войти

Язык сайта

Evimarko API для программистов

Подключите сайт, форму, бота или бухгалтерию к Evimarko: читайте услуги, клиентов и записи, записывайте на свободное время и получайте событие, как только в студии что-то произошло.

Начать за 3 шага

  1. 1

    Получите ключ

    Владелец студии открывает Настройки → Интеграции → Для программистов и нажимает «Создать ключ». Ключ показываем один раз — скопируйте его.

  2. 2

    Сделайте первый запрос

    Передайте ключ в заголовке Authorization. GET /me ответит, какой студии принадлежит ключ.

  3. 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Нет ключа, ключ неверный или отозван.
402API не входит в тариф студии.
403У студии нет доступа, или ключ «только смотреть» пытается что-то создать.
404Такой записи в этой студии нет.
422Данные не прошли проверку, или время занято.
429Слишком много запросов. Подождите столько секунд, сколько указано в Retry-After.

Готовые приложения

Без кода: соедините Evimarko с тысячами других сервисов в сервисе автоматизации.

Zapier

Скоро

Триггеры: новая запись, смена статуса, авто готово, заказ выдан, новый клиент. Действия: создать клиента, создать запись, найти клиента, найти свободное время.

Make

Скоро

Мгновенные триггеры на события студии и модули для клиентов, услуг, свободного времени, записей и заказов.

n8n

Скоро

Узел сообщества n8n-nodes-evimarko: узел Evimarko с действиями и Evimarko Trigger на вебхуках.

Pipedream

Скоро

Источники событий студии и действия для клиентов и записей.

Чего API никогда не делает

  • Не принимает оплаты и не двигает деньги.
  • Ничего не удаляет в студии: ни клиентов, ни авто, ни заказы.
  • Не даёт доступа к другой студии — ключ принадлежит одной студии.
  • Мы храним только отпечаток ключа, а не сам ключ. Потеряли — создайте новый и отзовите старый.

Нужна помощь?

Напишите нам — поможем подключить. Telegram

Ещё нет аккаунта Evimarko? Попробуйте CRM бесплатно и создайте ключ API за две минуты.