EN

Dokumentácia API Ragnetiq

Dáta z produktov Ragnetiq ako JSON cez HTTPS – pre vlastný reporting, dátový sklad alebo BI nástroj.

Produkty

AI asistent · API štatistíkAI asistent v chate e-shopu: konverzácie, odporúčané produkty, košíky a objednávky z chatu.as_… · asistent.ragnetiq.com/api/stats/v1Smart Search · API štatistíkVyhľadávanie v e-shope: hľadané výrazy, prekliky, košík a objednávky po vyhľadávaní.ss_… · search.ragnetiq.com/api/stats/v1SmartBox · API štatistíkAI box s otázkami a odpoveďami pri produkte: otázky zákazníkov, odpovede a pripísané objednávky.sb_… · smartbox.ragnetiq.com/api/stats/v1

Ako začať

  1. Napíšte nám na info@ragnetiq.com: kľúč vystavíme pre vaše obchody (pri SmartBoxe a AI asistentovi aj pre jednotlivé jazykové mutácie). Každý produkt má vlastný kľúč.
  2. Prečítajte si Základy API: kľúč, obdobie, stránkovanie, limity a chyby sú vo všetkých produktoch rovnaké.
  3. Pošlite prvú požiadavku zo servera – kľúč nikdy nedávajte do prehliadača:
curl "https://smartbox.ragnetiq.com/api/stats/v1/summary?from=2026-10-01&to=2026-10-15" \
  -H "Authorization: Bearer $RAGNETIQ_API_KEY"

Spoločné pre všetky API

  • Iba GET, odpovede JSON v UTF-8, kľúč v hlavičke Authorization: Bearer ….
  • Obdobie from/to najviac 366 dní, dni sa počítajú v Europe/Bratislava ako v administrácii.
  • Najviac 120 požiadaviek za minútu na kľúč, surové dáta po stranách (after, limit, next).
  • Tie isté kľúče fungujú v MCP serveri: pripojte štatistiky do Claude, ChatGPT alebo Cursora.
  • Verzia je v adrese API (/v1); v rámci verzie polia neodoberáme ani nemeníme ich význam.

O Ragnetiq

Ragnetiq s.r.o. je slovenská AI a softvérová spoločnosť. Pre e-shopy robí Ragnetiq AI asistent (AI chat, ktorý zákazníkom radí a odporúča produkty), Ragnetiq Smart Search (AI vyhľadávanie), Ragnetiq SmartBox (AI otázky a odpovede pri produkte) a Ragnetiq Recommender (odporúčania produktov).

Táto dokumentácia popisuje ich API a MCP server. Produkty, ceny a prípadové štúdie sú na www.ragnetiq.com.