Към съдържанието
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 ключ за две минути.