Începere rapidă

API-ul REST notso WMS pune la dispoziție aceleași operațiuni ca interfața WMS: comenzi, stocuri, produse, furnizori, locații și configurarea curierilor.

URL de bază

https://<tenantul-tău>.notsowms.ro/api/v1

Fiecare tenant rulează pe propriul subdomeniu (de exemplu tenant.notsowms.ro) și are propria bază de date izolată. Cererile API se trimit direct către subdomeniul tenantului.

Autentificare

Fiecare cerere trebuie să conțină un Bearer token în formatul <slug-tenant>.<cheie>, în antetul Authorization. Este singura metodă acceptată: X-API-Key și ?api_key= nu funcționează.

Authorization: Bearer tenant.7c4a8d09ca3762af61e59520943dc26494f8941b

Fiecare cheie are autoritate explicită: proprietar (tenant, stoc propriu sau client), utilizator responsabil, depozite (toate sau unul fixat) și o listă de capabilități alese una câte una, fără acces complet. Cheile expiră (implicit 90 de zile, cel mult 365), se rotesc cu o suprapunere scurtă și se revocă fără a fi șterse. Vezi ghidul de autentificare pentru emitere, rotație, revocare, excepțiile la nivel de client (produse și avize) și migrarea cheilor vechi spre modul strict.

Versiuni

API-ul este versionat la nivel de URL (/api/v1). Modificările incompatibile cu versiunile anterioare apar sub un prefix nou de versiune (/v2, /v3); versiunile existente rămân active o perioadă, înainte de a fi scoase din uz.

Convenții

• Toate cererile și răspunsurile sunt JSON, dacă nu se specifică altfel.
• Marcajele de timp sunt în format ISO 8601, cu fus orar (2026-04-27T13:24:35+00:00).
• Valorile monetare sunt transmise ca șiruri zecimale, ca să eviți erorile de rotunjire în virgulă mobilă.
• Paginarea folosește formatul standard al paginatorului Laravel — rândurile în data, cu metadatele de paginare la nivelul de sus.