Zdroje

Veřejné REST API WareRushAI (pouze pro čtení)

Čtěte své produkty, skladové zásoby, objednávky, chybějící data a chyby na marketplace ze služeb Zapier, Make, n8n nebo z vlastního kódu pomocí API klíče. Včetně specifikace OpenAPI 3.1.

Revised:

1. Co to je

REST API WareRushAI umožňuje jiným aplikacím číst data jedné společnosti: produkty, zásoby podle lokací, objednávky, produkty s chybějícími daty a chyby v nabídkách na marketplace. V této verzi je pouze pro čtení a běží na stejných službách a kontrolách oprávnění jako webová aplikace a konektor MCP. Základní adresa je https://app.warerushai.com/api/v1. API se zpřístupňuje postupně: dokud není pro platformu aktivováno, každé volání vrací 404 a nelze vytvářet žádné klíče.

2. Vytvoření API klíče

Vlastník nebo administrátor otevře Nastavení, poté Integrace, následně API klíče, pojmenuje klíč, vybere oprávnění (catalog.read, inventory.read, orders.read, account.read), platnost a limit za minutu a klíč vytvoří. Celý klíč začíná předponou wra_live_ a zobrazí se pouze jednou. WareRushAI ukládá pouze jednosměrný hash a první znaky, takže ztracený klíč nelze obnovit: je nutné vytvořit nový. Klíč můžete kdykoli zneplatnit nebo jej obměnit (rotovat): nový klíč se zobrazí jednou a starý zůstává funkční dalších 24 hodin.

3. Autentizace

Klíč posílejte v hlavičce Authorization: Authorization: Bearer wra_live_... přes HTTPS. Klíč nikdy nevkládejte do webové adresy; takový požadavek bude zamítnut s kódem key_in_url. Příklad: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Přístupové tokeny OAuth 2.1 konektoru MCP jsou rovněž přijímány s oprávněními, která uživatel schválil.

4. Koncové body

GET /me (klíč, jeho limity a dnešní využití), GET /products (vyhledávání a výpis pomocí parametrů query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (položky zásob, stránkované), GET /inventory/summary, GET /orders (s parametry updated_since, status, source, limit, cursor), GET /missing-data a GET /marketplace-errors (s parametrem channel). Každý koncový bod vyžaduje odpovídající oprávnění: catalog.read pro produkty, chybějící data a chyby na marketplace; inventory.read pro lokace a zásoby; orders.read pro objednávky. Podporována je pouze metoda GET; ostatní metody vracejí 405.

5. Stránkování a dotazování (polling)

Seznamy vracejí data, next_cursor a has_more, s maximálně 50 položkami na stránku (limit 1 až 50, výchozí hodnota 20). Pro získání další stránky předejte next_cursor zpět jako parametr cursor. Pro spouštěče dotazování ve službách Zapier, Make a n8n zavolejte GET /orders?updated_since=2026-11-15T08:00:00Z a uložte si čas posledního úspěšného dotazu: získáte objednávky vytvořené nebo změněné od tohoto okamžiku, seřazené od nejnovějších.

6. Limity a chyby

Každý klíč má limit za minutu (výchozí 60, maximálně 600) a volitelný denní limit. Každá společnost má také denní kvótu podle plánu: standardně 1 000 volání pro Starter, 10 000 pro Business a 100 000 pro Pro. Po dosažení limitu API odpoví kódem 429 s hlavičkou Retry-After. Hlavičky X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit a X-Daily-Remaining ukazují zbývající kapacitu. Chyby mají vždy formát {"error":{"code","message","request_id"}}; při kontaktu s podporou uveďte request_id. Běžné kódy: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited a daily_quota_exceeded (429).

7. Specifikace OpenAPI

Strojově čitelná specifikace OpenAPI 3.1 je k dispozici na adrese https://app.warerushai.com/api/v1/openapi.json a nevyžaduje klíč. Importujte ji do nástrojů Postman, Zapier, Make, n8n nebo AI asistenta a získejte všechny koncové body, parametry a struktury odpovědí. Změny jsou prováděny bez narušení stávajících polí; verze je /api/v1.

8. Zabezpečení

Klíče patří výhradně jedné společnosti a jsou ověřovány při každém volání; klíč nemůže nikdy číst data jiné společnosti a přestane fungovat, pokud administrátor, který jej vytvořil, společnost opustí. Klíče se nikdy neobjevují v protokolech ani chybových hlášeních a protokol volání zobrazuje pouze cestu, stav a čas. Finanční údaje, jako jsou nákupní ceny, toto API neposkytuje.