Referința API

Toate rutele din lotul 1, grupate pe resursă.

Contractul complet, mașină-citibil, e în OpenAPI (v1.json). Paginile de mai jos explică fiecare resursă în cuvinte.

Convenții

JSON, camelCase, identificatori opaci.
Date calendaristice AAAA-LL-ZZ; momente ISO 8601, UTC.
Sume ca șiruri zecimale, cu moneda alături ("budget": "700.00", "currency": "EUR").
Răspuns individual: { "data": … }. Listă: { "data": […], "hasMore": …, "nextCursor": … }.
Toate rutele de listă acceptă limit (cel mult 20) și cursor.

Resurse

Resursă	Rute
Anunțuri	`GET /listings`, `/listings/{ref}`, `/listings/mine`
Oferte	`GET /listings/{ref}/offers`, `/offers/mine`, `/offers/{id}`
Vehicule libere	`GET /vehicles`, `/vehicles/{id}`, `/vehicles/mine`
Localități și cost	`GET /places`, `/cost-estimate`
Firme	`GET /companies/{id}`
Evenimente	`GET /events/types` (catalog; livrarea e planificată)

Autentificare

Authorization: Bearer ajk_live_…, opțională la rutele publice (leagă cursorul și limitele de cheie, nu de adresă), obligatorie la restul. Vezi Autentificarea cu chei.

Erori

Un singur format, cu requestId stabil pentru suport. Vezi Erori.