Úvod do Unifyo REST API

Autentifikácia

Unifyo používa session cookies pre webovú appku, ale pre programatický prístup vystavujeme API token:

1. Otvor Nastavenia → API tokeny (Pro+ feature).
2. Klikni Vytvoriť token, daj mu meno (napr. "Zapier integration").
3. Token sa zobrazí iba raz — uchovaj si ho v bezpečí.

V requestoch posielaj:

Authorization: Bearer unifyo_pat_xxxxxxxxxxxxxxxxxxxx

Base URL

https://unifyo.online/api

Rate limits

• 60 requestov / minútu / token (default)
• Špecifické endpointy môžu mať prísnejšie limity (napr. /api/marketing/campaigns POST = 10/min)

Pri prekročení dostaneš 429 Too Many Requests s Retry-After headerom.

Príklady

List CRM kontaktov

GET /api/crm/contacts

Odpoveď:

json
[
  {
    "id": "cmoxxx",
    "name": "Peter Novák",
    "email": "peter@example.com",
    "phone": "+421 950 312 345",
    "company": "Demo s.r.o.",
    "createdAt": "2026-05-08T09:30:00.000Z"
  }
]

Vytvorenie kontaktu

POST /api/crm/contacts
Content-Type: application/json
{
  "name": "Mária Kováčová",
  "phone": "+421 904 555 123",
  "email": "maria@example.com"
}

Pri duplicite (rovnaký telefón / email / meno) sa kontakt mergne namiesto vytvorenia dupu — odpoveď obsahuje _merged: true.

Audit log (Enterprise)

GET /api/user/audit-log?format=csv

Vráti CSV stream s históriou login-ov, zmien plánu, kampaní a iných eventov.

Webhooks

Pre real-time eventy (kampaň poslaná, deal vytvorený) použi webhooks — viď /docs/api-webhooks.

Limity

• Token má rovnaké tier limity ako tvoj plán (40 AI msgs/deň na Basic, atď.)
• Token nemá administrátorské práva — nemôže mazať tvoj účet ani meniť heslo
• Token sa dá kedykoľvek revoke v Nastavenia → API tokeny