Introducere API - Amovio Docs

Prezentare generală

API-ul Amovio urmează convențiile REST. Toate răspunsurile sunt în format JSON. Accesul este securizat prin Bearer Token (JWT).

POST /auth/login
Content-Type: application/json

{
  "email": "user@firma.ro",
  "password": "parola_ta"
}

Răspuns:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

Includ token-ul în header-ul Authorization la fiecare request:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

https://api.amovio.ro/v1

Toate listele sunt paginate:

GET /vehicles?page=1&limit=20

Răspuns:

{
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 154,
    "totalPages": 8
  }
}

Cod HTTP	Descriere
`400`	Date invalide în request
`401`	Token lipsă sau expirat
`403`	Acces interzis (permisiuni insuficiente)
`404`	Resursa nu a fost găsită
`422`	Eroare de validare câmpuri
`500`	Eroare internă server

Amovio poate trimite notificări HTTP la URL-ul tău când se produc evenimente:

Eveniment	Descriere
`lead.created`	Lead nou creat
`invoice.validated`	Factură validată de ANAF
`contract.signed`	Contract semnat de ambele părți
`vehicle.sold`	Vehicul marcat ca vândut

Configurează webhook-ul din Setări → API → Webhooks.