Resurse

API REST public WareRushAI (doar citire)

Citește produsele, stocurile, comenzile, datele lipsă și erorile de marketplace din Zapier, Make, n8n sau din propriul cod cu o cheie API. Include descrierea OpenAPI 3.1.

Revised:

1. Ce este

API-ul REST WareRushAI permite altor programe să citească datele unei companii: produse, stocuri pe locații, comenzi, produse cu date lipsă și erori de listare pe marketplace-uri. În această versiune este doar pentru citire (read-only) și se bazează pe aceleași servicii și verificări de permisiuni ca aplicația web și conectorul MCP. Adresa de bază este https://app.warerushai.com/api/v1. API-ul este deschis treptat: până când este activat pentru platformă, fiecare apel returnează 404 și nu pot fi create chei.

2. Creează o cheie API

Un proprietar sau administrator deschide Setări, apoi Integrări, apoi Chei API, denumește cheia, alege permisiunile (catalog.read, inventory.read, orders.read, account.read), o dată de expirare și o limită pe minut, apoi o creează. Cheia completă începe cu wra_live_ și este afișată o singură dată. WareRushAI stochează doar un hash unidirecțional și primele caractere, astfel încât o cheie pierdută nu poate fi recuperată: creați una nouă. Puteți revoca o cheie oricând sau o puteți roti: noua cheie este afișată o singură dată, iar cea veche continuă să funcționeze timp de 24 de ore.

3. Autentificare

Trimiteți cheia în antetul Authorization: Authorization: Bearer wra_live_... prin HTTPS. Nu includeți niciodată cheia în adresa web; o solicitare care face acest lucru este respinsă cu key_in_url. Exemplu: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Tokenurile de acces OAuth 2.1 ale conectorului MCP sunt de asemenea acceptate, cu permisiunile aprobate de utilizator.

4. Puncte finale (Endpoints)

GET /me (cheia, limitele sale și utilizarea de astăzi), GET /products (căutare și listare, cu query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (linii de stoc, paginate), GET /inventory/summary, GET /orders (cu updated_since, status, source, limit, cursor), GET /missing-data și GET /marketplace-errors (cu channel). Fiecare endpoint necesită permisiunea corespunzătoare: catalog.read pentru produse, date lipsă și erori de marketplace, inventory.read pentru locații și stocuri, orders.read pentru comenzi. Este acceptat doar GET; alte metode returnează 405.

5. Paginare și interogare periodică (polling)

Listele returnează data, next_cursor și has_more, cu cel mult 50 de elemente pe pagină (limit între 1 și 50, implicit 20). Trimiteți next_cursor înapoi ca parametru cursor pentru a obține pagina următoare. Pentru declanșatorii de interogare periodică (polling) din Zapier, Make și n8n, apelați GET /orders?updated_since=2026-11-15T08:00:00Z și rețineți ora ultimei interogări reușite: primiți comenzile create sau modificate de atunci, cele mai noi fiind primele.

6. Limite și erori

Fiecare cheie are o limită pe minut (implicit 60, maximum 600) și o limită zilnică opțională. Fiecare companie are, de asemenea, o cotă zilnică în funcție de plan: implicit 1 000 de apeluri pentru Starter, 10 000 pentru Business și 100 000 pentru Pro. Când este atinsă o limită, API-ul răspunde cu 429 și un antet Retry-After. Anteturile X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit și X-Daily-Remaining arată ce a rămas disponibil. Erorile au întotdeauna structura {"error":{"code","message","request_id"}}; menționați parametrul request_id atunci când contactați asistența. Coduri comune: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited și daily_quota_exceeded (429).

7. Descriere OpenAPI

Descrierea OpenAPI 3.1 prelucrabilă automat este disponibilă la https://app.warerushai.com/api/v1/openapi.json și nu necesită nicio cheie. Importați-o în Postman, Zapier, Make, n8n sau într-un asistent AI pentru a obține toate punctele finale, parametrii și formatele de răspuns. Modificările sunt efectuate fără a afecta câmpurile existente; versiunea este /api/v1.

8. Securitate

Cheile aparțin unei singure companii și sunt verificate la fiecare apel; o cheie nu poate citi niciodată datele altei companii și încetează să funcționeze dacă administratorul care a creat-o părăsește compania. Cheile nu apar niciodată în jurnale sau în mesajele de eroare, iar jurnalul de apeluri arată doar calea, starea și ora. Datele financiare, cum ar fi prețurile de achiziție, nu sunt expuse de acest API.