Co opravdu můžeš volat

Vlož jednu značku skriptu na libovolný web. Ukáže cookie banner, počká na souhlas a události posílá sám. Na to nevoláš žádný endpoint a v prohlížeči není co ověřovat.

<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>

Pro úplnost: skript volá tři endpointy, GET /api/consent/sdk-settings/:clientId pro nastavení projektu, POST /api/v2/collect pro události a POST /api/v2/collect/heartbeat pro kontrolu instalace. Jsou veřejné, ověřují se podle ID projektu a nejsou určeny k ručnímu volání. POST /api/collect neexistuje.

GET /api/pixel/:clientId

Průhledný GIF 1x1. Vlož ho do e-mailu nebo newsletteru a zaznamenáš otevření. Parametry: t druh (výchozí pixel_impression), c kampaň, r příjemce. Vždy odpoví obrázkem.

GET /api/links/r/:shortCode

Sledovaný krátký odkaz. Zaznamená klik (zařízení, odkazující web) a přesměruje kódem 302 na cíl s přidanými UTM parametry odkazu. 404 pro neznámý odkaz, 410 pro vypršený.

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

Klíč pošli v hlavičce x-api-key (nebo jako Authorization: Bearer). ID projektu pošli jako client_id v těle, v query nebo v hlavičce x-client-id. Klíč najdeš v detailu projektu v aplikaci. Vidí ho a obnovit ho může jen správce projektu.

POST /api/proxy/track

Zaznamená nejvýše 50 událostí v jednom požadavku. Každá událost přijímá event_name (nebo n), properties (nebo d), page, referrer a timestamp v milisekundách. Pokud chybí session_id a visitor_id, doplní se. Odpověď: { success, processed, events }.

POST /api/proxy/identify

Spojí visitor_id s tvým user_id. E-mail v traits se uloží jako otisk, nikdy jako text.

GET /api/proxy/ecommerce/products

Jen pro čtení. Pro každý produkt (item_id) počty view_item, add_to_cart, begin_checkout a purchase a tržby z nákupů mezi from a to (výchozí je posledních 90 dní). Počítá jen návštěvy, které nejsou boti a daly souhlas s analytikou, proto je číslo nižší než počet z tvého serveru.

GET /api/proxy/health

Odpoví { status: ok }. Bez klíče.

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 neviděly cizí doménu, dej skriptu adresu vlastní cesty jako proxyUrl. Nahradí https://api.conseto.io/api jako základ všech tří volání skriptu. Tvůj server pak tuto cestu přeposílá na https://api.conseto.io/api a tělo posílá dál.

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

Obecný

1 000 požadavků za 15 minut na IP adresu, pro volání skriptu, proxy projektu a endpointy souhlasu.

Pixel a krátké odkazy

120 požadavků za minutu na IP adresu.

Na projekt, ze skriptu

Strop na to, co může jeden projekt poslat za 15 minut: 2 000 požadavků na Free a Starter, 4 000 na Business, 20 000 na Enterprise.

Návštěvy na web

Free dovoluje 10 000 návštěv na web za 30 dní, Starter a Business 100 000, Enterprise nemá strop. Nad to dostane nová návštěva 429 s SESSION_LIMIT_EXCEEDED. Návštěvy, které už běží, pokračují.

MCP

30 požadavků za minutu na klíč a 120 za minutu na IP adresu ještě před ověřením klíče.

Nejblíže k datovému API má Conseto dnes MCP: připoj Claude Code, claude.ai nebo jiného MCP klienta na api.conseto.io/mcp a ptej se na návštěvnost, souhlas, vyhledávání a kontroly vlastními slovy. Jen pro čtení, jeden klíč na projekt, od plánu Business.

Zatím nepostavené, takže se na to dnes nedá napojit:

• Univerzální REST API a specifikace OpenAPI
• Odchozí webhooky pro tvé systémy
• Serverová SDK pro Node.js, Python a PHP
• Vlastní ověření dalších MCP klientů (ChatGPT, Claude Desktop, Cursor); dnes se připojují podle svého návodu