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 за дві хвилини.