API di Aralda

Consulta bandi, scadenze, filtri e fonti dai tuoi strumenti tramite API.

Autenticazione

https://api.aralda.com/v1

Authorization: Bearer arla_…

La chiave intera viene mostrata una sola volta. Copiala e custodiscila: non condividerla.

Piano	Richieste al giorno	Richieste al minuto	Risultati per pagina	Offset massimo
Cacciatore	200	30	25	500
Gilda	20.000	120	100	10.000
Maestro	2000	30	50	2500

Ricerca bandi per parole, paese, CPV, ente e scadenza.

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_…'

Scheda di un bando tramite il suo ID.

Parametri: id (UUID)

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

Bandi aperti ordinati per scadenza.

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_…'

Elenco dei tuoi filtri salvati.

Parametri: —

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

Nuovi bandi per un tuo filtro; la prima chiamata parte dagli ultimi 7 giorni, poi aggiorna l’ultima vista.

Parametri: id (UUID)

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

Elenco delle fonti attive e della loro licenza.

Parametri: —

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

{"ok":false,"family":"auth","correlation_id":"…"}

401 auth — Chiave assente o non valida.
402 abbonamento — Abbonamento non attivo o scaduto.
403 accesso — Il tuo piano non include l’accesso API.
429 quota — Limite di richieste raggiunto; riprova dopo l’intervallo indicato. · Retry-After
400 invalid_input — Parametri non validi.
404 not_found — Risorsa non trovata.