Zdroje

Verejné REST API WareRushAI (iba na čítanie)

Čítajte svoje produkty, zásoby, objednávky, chýbajúce údaje a chyby na trhoviskách cez Zapier, Make, n8n alebo vlastný kód pomocou API kľúča. Vrátane špecifikácie OpenAPI 3.1.

Revised:

1. O čo ide

REST API WareRushAI umožňuje iným programom čítať údaje jednej firmy: produkty, zásoby podľa lokácie, objednávky, produkty s chýbajúcimi údajmi a chyby zalistovania na trhoviskách. V tejto verzii je iba na čítanie a beží na rovnakých službách a kontrolách oprávnení ako webová aplikácia a konektor MCP. Základná adresa je https://app.warerushai.com/api/v1. API sprístupňujeme postupne: kým nie je pre platformu zapnuté, každé volanie vracia 404 a kľúče nie je možné vytvoriť.

2. Vytvorenie API kľúča

Vlastník alebo správca otvorí Nastavenia, potom Integrácie, následne API kľúče, pomenujte kľúč, vyberie oprávnenia (catalog.read, inventory.read, orders.read, account.read), platnosť a limit volaní za minútu a vytvorí ho. Celý kľúč sa začína na wra_live_ a zobrazí sa iba raz. WareRushAI ukladá iba jednosmerný hash a úvodné znaky, takže stratený kľúč nie je možné obnoviť: vytvorte nový. Kľúč môžete kedykoľvek odvolať alebo ho rotovať: nový kľúč sa zobrazí raz a starý zostane funkčný ešte 24 hodín.

3. Autentifikácia

Kľúč posielajte v hlavičke Authorization: Authorization: Bearer wra_live_... cez HTTPS. Kľúč nikdy nevkladajte do webovej adresy; požiadavka s kľúčom v URL bude odmietnutá s chybou key_in_url. Príklad: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Podporované sú aj prístupové tokeny OAuth 2.1 z konektora MCP, a to s oprávneniami, ktoré používateľ schválil.

4. Koncové body

GET /me (kľúč, jeho limity a dnešné využitie), GET /products (vyhľadávanie a zoznam s parametrami query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (položky zásob, stránkované), GET /inventory/summary, GET /orders (s updated_since, status, source, limit, cursor), GET /missing-data a GET /marketplace-errors (s parametrom channel). Každý koncový bod vyžaduje príslušné oprávnenie: catalog.read pre produkty, chýbajúce údaje a chyby na trhoviskách, inventory.read pre lokácie a zásoby, orders.read pre objednávky. Podporovaná je iba metóda GET; ostatné metódy vracajú 405.

5. Stránkovanie a polling

Zoznamy vracajú data, next_cursor a has_more, s maximálne 50 položkami na stránku (limit od 1 do 50, predvolene 20). Pre načítanie ďalšej stránky pošlite hodnotu next_cursor ako parameter cursor. Pre polling triggery v nástrojoch Zapier, Make a n8n volajte GET /orders?updated_since=2026-11-15T08:00:00Z a uložte si čas posledného úspešného dopytu: získate objednávky vytvorené alebo upravené odvtedy, zoradené od najnovších.

6. Limity a chyby

Každý kľúč má minútový limit (predvolene 60, maximálne 600) a voliteľný denný limit. Každá firma má tiež denný limit podľa plánu: predvolene 1 000 volaní pre Starter, 10 000 pre Business a 100 000 pre Pro. Pri dosiahnutí limitu API odpovie kódom 429 s hlavičkou Retry-After. Hlavičky X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit a X-Daily-Remaining zobrazujú zostávajúci počet volaní. Chybové odpovede majú vždy štruktúru {"error":{"code","message","request_id"}}; pri kontaktovaní podpory uveďte request_id. Časté kódy: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited a daily_quota_exceeded (429).

7. Popis OpenAPI

Strojovo čitateľný popis OpenAPI 3.1 je dostupný na https://app.warerushai.com/api/v1/openapi.json a nevyžaduje kľúč. Naimportujte si ho do aplikácií Postman, Zapier, Make, n8n alebo do asistenta AI, aby ste získali všetky koncové body, parametre a štruktúry odpovedí. Zmeny vykonávame spätne kompatibilne bez narušenia existujúcich polí; verzia je /api/v1.

8. Bezpečnosť

Kľúče patria presne jednej firme a overujú sa pri každom volaní; kľúč nikdy nemôže čítať údaje inej firmy a prestane fungovať, ak správca, ktorý ho vytvoril, firmu opustí. Kľúče sa nikdy nezobrazujú v protokoloch ani chybových hláseniach a denník volaní obsahuje iba cestu, stavový kód a čas. Finančné údaje, ako sú nákupné ceny, toto API neposkytuje.