Documentație API

Referință pentru integratori ERP / WMS / aplicații mobile: REST v1/v2, GraphQL, webhook-uri outbound și playground live.

URL de bază: https://www.flowscmc.ro/api · GraphQL: https://www.flowscmc.ro/graphql

Schema OpenAPI 3.0 (importabilă în Postman / Insomnia / codegen): https://www.flowscmc.ro/openapi.json

Arhitectură pe scurt

• REST v1 (/api/…) - resurse operaționale stabile (articole, stoc, PO/SO, recepții, retururi, referință, webhook-uri).
• REST v2 (/api/v2/…) - cursor, fields, batch, ambalaje; fără breaking pe v1.
• GraphQL - interogări/mutări pe același model de autentificare.
• Webhook-uri - evenimente push către URL-ul dvs. (HTTPS).
• Integrări inbound (eTSM, MDM) - Bearer partajat, nu token Sanctum; vezi documentația eTSM.

În 5 minute

1. Obțineți un token: POST /api/auth/token
2. Trimiteți Authorization: Bearer … la fiecare cerere
3. Pentru date operaționale adăugați X-Company-Id (compania client 3PL)
4. Verificați modulele: fiecare rută cere modulul API + modulul de conținut (ex. inbound pentru recepții)
5. Testați din Playground REST

curl -s -X POST https://www.flowscmc.ro/api/auth/token \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"email":"utilizator@exemplu.ro","password":"parola-dvs"}'

# Răspuns tipic:
# { "token": "1|abc…", "user": { "id": 1, "name": "…", "email": "…" } }

Convenții