До змісту
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 за дві хвилини.