GET/v1/listings

Anunțuri

Căutare publică și anunțurile tale.

Caută anunțuri publicate

curl "https://api.ajungem.ro/v1/listings?category=freight&fromCountry=DE&toCountry=RO&limit=20"

Parametri de interogare: category (car, move, parcel, freight), fromCountry, toCountry (cod ISO, 2 litere), dateFrom, dateTo (AAAA-LL-ZZ), weightMax (kg), volumeMax (m³), truckTypes (listă separată prin virgulă), limit, cursor.

assistance (asistență rutieră) nu apare aici: e un flux dedicat, doar în site.

Ieșire: ref, category, fromCity, fromCountry, toCity, toCountry, dateType, dateFrom, dateTo, description, budget, currency, urgent, needsInvoice, paymentDays, weightKg, volumeM3, truckTypes, status, createdAt, expiresAt, estimatedCost, distanceKm, url. Vezi obiectul Listing.

Un anunț, după cod

curl https://api.ajungem.ro/v1/listings/7J769R

Proiecție publică pentru oricine. Dacă ești titularul sau transportatorul ales, primești în plus transportStage și stageUpdatedAt — trimite o cheie ca să le vezi.

404 not_found pentru un cod inexistent.

Anunțurile tale

curl https://api.ajungem.ro/v1/listings/mine \
  -H "Authorization: Bearer ajk_live_…"

Necesită permisiunea listings:read (o are orice cheie nouă). Întoarce anunțurile publicate de contul din spatele cheii — nu ale întregii firme: un anunț e al persoanei care l-a publicat, nu al firmei ei.

🛠️

POST /listings, POST /listings/{ref}/cancel și POST /listings/{ref}/stage sunt planificate pentru lotul 2. Publică din site sau prin serverul MCP.