API Aralda

Consultă licitații, termene, filtre și surse din instrumentele tale prin API.

Autentificare

https://api.aralda.com/v1
Authorization: Bearer arla_…

Cheia completă este afișată o singură dată. Copiaz-o și păstreaz-o în siguranță: nu o distribui.

Chei API

Limite pe plan

PlanCereri pe ziCereri pe minutRezultate pe paginăDecalaj maxim
Vânător2003025500
Breaslă20.00012010010.000
Maestru2.00030502.500
Planuri și prețuri

Rute disponibile

GET /search

Caută licitații după cuvinte, țară, CPV, cumpărător și termen.

Parametri: q, paese (ISO2, CSV ≤10), cpv ([0-9]{1,8}, CSV ≤10), ente, scadenza_giorni (1–365), pagina, per_page

curl 'https://api.aralda.com/v1/search?q=software&paese=IT&pagina=1&per_page=10' \
  -H 'Authorization: Bearer arla_…'

GET /tenders/{id}

Detalii despre o licitație prin ID.

Parametri: id (UUID)

curl 'https://api.aralda.com/v1/tenders/00000000-0000-4000-8000-000000000001' \
  -H 'Authorization: Bearer arla_…'

GET /deadlines

Licitații deschise ordonate după termen.

Parametri: giorni (1–365), limite (1–200, ≤ per_page), pagina, per_page

curl 'https://api.aralda.com/v1/deadlines?giorni=30&limite=10&per_page=10' \
  -H 'Authorization: Bearer arla_…'

GET /filters

Lista filtrelor tale salvate.

Parametri: —

curl 'https://api.aralda.com/v1/filters' \
  -H 'Authorization: Bearer arla_…'

GET /filters/{id}/new

Licitații noi pentru filtrul tău; primul apel acoperă ultimele 7 zile, apoi actualizează ultima vizualizare.

Parametri: id (UUID)

curl 'https://api.aralda.com/v1/filters/00000000-0000-4000-8000-000000000002/new' \
  -H 'Authorization: Bearer arla_…'

GET /sources

Lista surselor active și a licenței lor.

Parametri: —

curl 'https://api.aralda.com/v1/sources' \
  -H 'Authorization: Bearer arla_…'

Erori

{"ok":false,"family":"auth","correlation_id":"…"}
  • 401 auth — Cheie lipsă sau nevalidă.
  • 402 abbonamento — Abonament inactiv sau expirat.
  • 403 accesso — Planul tău nu include acces API.
  • 429 quota — Limita de cereri a fost atinsă; încearcă după intervalul indicat. · Retry-After
  • 400 invalid_input — Parametri nevalizi.
  • 404 not_found — Resursa nu a fost găsită.