Revised:
1. Kaj je to
REST API za WareRushAI omogoča drugim programom branje podatkov enega podjetja: izdelkov, zaloge po lokacijah, naročil, izdelkov z manjkajočimi podatki in napak pri objavi na tržnicah. V tej različici je na voljo samo za branje ter temelji na istih storitvah in preverjanjih dovoljenj kot spletna aplikacija in priključek MCP. Osnovni naslov je https://app.warerushai.com/api/v1. API se odpira postopoma: dokler ni vklopljen za platformo, vsak klic vrne kodo 404 in ključev ni mogoče ustvariti.
2. Ustvarite API-ključ
Lastnik ali skrbnik odpre Nastavitve, nato Integracije, nato API-ključi, poimenuje ključ, izbere dovoljenja (catalog.read, inventory.read, orders.read, account.read), veljavnost ter omejitev na minuto in ga ustvari. Celoten ključ se začne z wra_live_ in je prikazan samo enkrat. WareRushAI shrani le enosmerno zgoščeno vrednost (hash) in začetne znake, zato izgubljenega ključa ni mogoče obnoviti: ustvarite novega. Ključ lahko kadar koli prekličete ali zamenjate (rotate): novi ključ se prikaže enkrat, stari pa deluje še 24 ur.
3. Preverjanje pristnosti
Ključ pošljite v glavi Authorization: Authorization: Bearer wra_live_... prek HTTPS. Ključa nikoli ne vnašajte v spletni naslov; zahteva, ki to stori, je zavrnjena z napako key_in_url. Primer: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Sprejeti so tudi dostopni žetoni OAuth 2.1 priključka MCP z dovoljenji, ki jih je uporabnik odobril.
4. Končne točke
GET /me (ključ, njegove omejitve in današnja poraba), GET /products (iskanje in seznam s parametri query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (postavke zaloge, oštevilčeno), GET /inventory/summary, GET /orders (s parametri updated_since, status, source, limit, cursor), GET /missing-data in GET /marketplace-errors (s parametrom channel). Vsaka končna točka potrebuje ustrezno dovoljenje: catalog.read za izdelke, manjkajoče podatke in napake na tržnicah, inventory.read za lokacije in zalogo, orders.read za naročila. Podprta je le metoda GET; druge metode vrnejo 405.
5. Paginacija in poizvedovanje (polling)
Seznami vrnejo data, next_cursor in has_more, z največ 50 elementi na stran (limit od 1 do 50, privzeto 20). Vrednost next_cursor posredujte nazaj kot cursor, da pridobite naslednjo stran. Za sprožilce poizvedovanja v orodjih Zapier, Make in n8n pokličite GET /orders?updated_since=2026-11-15T08:00:00Z in si zapomnite čas zadnjega uspešnega poizvedovanja: prejmete naročila, ustvarjena ali spremenjena od takrat, najnovejša najprej.
6. Omejitve in napake
Vsak ključ ima omejitev na minuto (privzeto 60, največ 600) in izbirno dnevno omejitev. Vsako podjetje ima tudi dnevno kvoto glede na paket: privzeto 1 000 klicev za Starter, 10 000 za Business in 100 000 za Pro. Ko je omejitev dosežena, API odgovori s kodo 429 in glavo Retry-After. Glave X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit in X-Daily-Remaining prikazujejo, koliko klicev je še na voljo. Napake so vedno v obliki {"error":{"code","message","request_id"}}; pri stiku s podporo navedite request_id. Pogoste kode: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited in daily_quota_exceeded (429).
7. Opis OpenAPI
Strojno berljiv opis OpenAPI 3.1 je na voljo na https://app.warerushai.com/api/v1/openapi.json in ne potrebuje ključa. Uvozite ga v Postman, Zapier, Make, n8n ali pomočnika AI, da pridobite vse končne točke, parametre in oblike odgovorov. Spremembe se uvajajo brez spreminjanja obstoječih polj; različica je /api/v1.
8. Varnost
Ključi pripadajo natanko enemu podjetju in se preverijo ob vsakem klicu; ključ nikoli ne more brati podatkov drugega podjetja in preneha delovati, če skrbnik, ki ga je ustvaril, zapusti podjetje. Ključi se nikoli ne pojavijo v dnevnikih ali sporočilih o napakah, dnevnik klicev pa prikazuje le pot, stanje in čas. Finančni podatki, kot so nabavne cene, prek tega API-ja niso izpostavljeni.
