Base URL
https://datanostro.com/api/
Všechny endpointy jsou v1. Verze v URL přijde s breaking change.
QUICK START
Tři kroky k prvnímu requestu
-
1
Vygenerujte API klíč
V dashboardu → API klíče → Vytvořit klíč. Token zobrazíme jednou — uložte si ho hned.
Otevřít API klíče -
2
Pošlete první request
Authorization header s vaším tokenem. JSON v request body, JSON v odpovědi.
curl https://datanostro.com/api/tenants/ \ -H "Authorization: Token YOUR_TOKEN"
-
3
Prozkoumejte schema
Swagger UI nabízí try-it-now panel — pošlete request přímo z prohlížeče.
Otevřít Swagger UI
TECHNICKÉ DETAILY
Co potřebujete vědět
Autentizace
Authorization: Token <token>
Per-tenant API klíče s odvolatelnými tokeny. Session auth funguje pro web UI.
Rate limits
100 req/min na token. Při překročení vracíme HTTP 429 s Retry-After headerem.
Formát odpovědi
JSON, UTF-8, snake_case. Časy v ISO 8601 (UTC). Stránkování přes ?page=1&page_size=50.
Stabilita
Breaking changes oznamujeme v changelogu min. 60 dní předem.
Status + uptime
Stav API najdete na status stránce. Cílem je oznámit incident do několika minut od detekce monitorem.
PARTNERSKÉ API
Tracking Checker API
Stejný scanner jako veřejný Tracking Checker — programatický pro agentury a integrátory. Vraťuje JSON s detekcí trackerů, AI shrnutím, PageSpeed skóre a odhadem ztrát.
POST /api/v1/tracking-checker/scan
curl -X POST https://datanostro.com/api/v1/tracking-checker/scan/ \
-H "Authorization: ApiKey dn_yourtenant_xxxx" \
-H "Content-Type: application/json" \
-d '{
"url": "https://eshop.cz",
"ai_summary": true,
"pagespeed": true,
"language": "cs"
}'
- Auth: API klíč v hlavičce
Authorization: ApiKey <token> - Rate limit: 60 scanů / hodinu na projektu. Agency / Partner plány bumpneme přes
Plan.features['tracking_checker_api_hourly']. - AI summary používá Gemini, PageSpeed Insights je z Google API. Odpověď obsahuje
api_meta.request_idpro logování.