Î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>:

Authorization: Bearer tenant.eyJhbGc...

Vezi ghidul de autentificare pentru cum se emit și se rotesc tokenurile.

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.