Čo naozaj môžeš volať

Vlož jednu značku skriptu na ľubovoľný web. Ukáže cookie banner, počká na súhlas a udalosti posiela sám. Na to nevoláš žiadny endpoint a v prehliadači sa nemá čo overovať.

<link rel="preconnect" href="https://api.conseto.io">
<script>
  window.dataLayer = window.dataLayer || [];
  window.gtag = window.gtag || function () { dataLayer.push(arguments); };
  gtag('consent', 'default', {
    ad_storage: 'denied', ad_user_data: 'denied',
    ad_personalization: 'denied', analytics_storage: 'denied',
    wait_for_update: 500
  });
  window.consetoQ = window.consetoQ || [];
  consetoQ.push(['init', { clientId: 'conseto_xxx_xxx' }]);
</script>
<script async src="https://www.conseto.io/dist/conseto.min.js"></script>

Pre úplnosť: skript volá tri endpointy, GET /api/consent/sdk-settings/:clientId na nastavenia projektu, POST /api/v2/collect na udalosti a POST /api/v2/collect/heartbeat na kontrolu inštalácie. Sú verejné a overujú sa podľa ID projektu a nie sú určené na ručné volanie. POST /api/collect neexistuje.

GET /api/pixel/:clientId

Priehľadný GIF 1x1. Vlož ho do e-mailu alebo newslettra a zaznamenáš otvorenie. Parametre: t druh (predvolene pixel_impression), c kampaň, r príjemca. Vždy odpovie obrázkom.

GET /api/links/r/:shortCode

Sledovaný krátky odkaz. Zaznamená klik (zariadenie, odkazujúci web) a presmeruje kódom 302 na cieľ s pridanými UTM parametrami odkazu. 404 pre neznámy odkaz, 410 pre vypršaný.

<img src="https://api.conseto.io/api/pixel/conseto_xxx_xxx?t=email_open&c=autumn-sale"
     width="1" height="1" alt="">

Kľúč pošli v hlavičke x-api-key (alebo ako Authorization: Bearer). ID projektu pošli ako client_id v tele, v query alebo v hlavičke x-client-id. Kľúč nájdeš v detaile projektu v appke. Vidí ho a obnoviť ho môže len správca projektu.

POST /api/proxy/track

Zaznamená najviac 50 udalostí v jednej požiadavke. Každá udalosť berie event_name (alebo n), properties (alebo d), page, referrer a timestamp v milisekundách. Ak chýba session_id a visitor_id, doplnia sa. Odpoveď: { success, processed, events }.

POST /api/proxy/identify

Spojí visitor_id s tvojím user_id. E-mail v traits sa uloží ako odtlačok, nikdy ako text.

GET /api/proxy/ecommerce/products

Len na čítanie. Pre každý produkt (item_id) počty view_item, add_to_cart, begin_checkout a purchase a tržby z nákupov medzi from a to (predvolene posledných 90 dní). Počíta len návštevy, ktoré nie sú boti a dali súhlas s analytikou, preto je číslo nižšie než počet z tvojho servera.

GET /api/proxy/health

Odpovie { status: ok }. Bez kľúča.

curl -X POST https://api.conseto.io/api/proxy/track \
  -H "Content-Type: application/json" \
  -H "x-api-key: csk_your_api_key" \
  -d '{
    "client_id": "conseto_xxx_xxx",
    "session_id": "your-session-id",
    "visitor_id": "your-visitor-id",
    "events": [
      { "event_name": "order_created", "properties": { "value": 49 }, "page": "https://your-site.com/checkout" }
    ]
  }'

curl -X POST https://api.conseto.io/api/proxy/identify \
  -H "Content-Type: application/json" \
  -H "x-api-key: csk_your_api_key" \
  -d '{ "client_id": "conseto_xxx_xxx", "visitor_id": "your-visitor-id", "user_id": "user_42" }'

curl "https://api.conseto.io/api/proxy/ecommerce/products?client_id=conseto_xxx_xxx&from=2026-09-01&to=2026-09-30" \
  -H "x-api-key: csk_your_api_key"

Aby reklamné blokátory nevideli cudziu doménu, daj skriptu adresu vlastnej cesty ako proxyUrl. Nahradí https://api.conseto.io/api ako základ všetkých troch volaní skriptu. Tvoj server potom túto cestu preposiela na https://api.conseto.io/api a telo posiela ďalej.

Požiadavka nad limit dostane 429 s { error, code: "RATE_LIMITED", retryAfter }.

Všeobecný

1 000 požiadaviek za 15 minút na IP adresu, pre volania skriptu, proxy projektu a endpointy súhlasu.

Pixel a krátke odkazy

120 požiadaviek za minútu na IP adresu.

Na projekt, zo skriptu

Strop na to, čo môže jeden projekt poslať za 15 minút: 2 000 požiadaviek na Free a Starter, 4 000 na Business, 20 000 na Enterprise.

Návštevy na web

Free dovoľuje 10 000 návštev na web za 30 dní, Starter a Business 100 000, Enterprise nemá strop. Nad to dostane nová návšteva 429 s SESSION_LIMIT_EXCEEDED. Návštevy, ktoré už bežia, pokračujú.

MCP

30 požiadaviek za minútu na kľúč a 120 za minútu na IP adresu ešte pred overením kľúča.

Najbližšie k dátovému API má Conseto dnes MCP: pripoj Claude Code, claude.ai alebo iného MCP klienta na api.conseto.io/mcp a pýtaj sa na návštevnosť, súhlas, vyhľadávanie a kontroly vlastnými slovami. Len na čítanie, jeden kľúč na projekt, od plánu Business.

Zatiaľ nepostavené, takže sa na to dnes nedá napojiť:

• Univerzálne REST API a špecifikácia OpenAPI
• Odchádzajúce webhooky pre tvoje systémy
• Serverové SDK pre Node.js, Python a PHP
• Vlastné overenie ďalších MCP klientov (ChatGPT, Claude Desktop, Cursor); dnes sa pripájajú podľa svojho návodu