Aralda-API

Rufe Ausschreibungen, Fristen, Filter und Quellen über die API in deinen Anwendungen ab.

Authentifizierung

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

Der vollständige Schlüssel wird nur einmal angezeigt. Kopiere ihn und bewahre ihn sicher auf: Teile ihn nicht.

API-Schlüssel

Tariflimits

TarifAnfragen pro TagAnfragen pro MinuteErgebnisse pro SeiteMaximaler Offset
Jäger2003025500
Gilde20.00012010010.000
Meister2.00030502.500
Tarife und Preise

Verfügbare Routen

GET /search

Suche Ausschreibungen nach Stichwörtern, Land, CPV, Auftraggeber und Frist.

Parameter: 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}

Details einer Ausschreibung anhand ihrer ID.

Parameter: id (UUID)

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

GET /deadlines

Offene Ausschreibungen nach Frist sortiert.

Parameter: 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

Liste deiner gespeicherten Filter.

Parameter: —

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

GET /filters/{id}/new

Neue Ausschreibungen für deinen Filter; der erste Aufruf umfasst die letzten 7 Tage und aktualisiert danach den Zeitpunkt der letzten Ansicht.

Parameter: id (UUID)

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

GET /sources

Liste der aktiven Quellen und ihrer Lizenz.

Parameter: —

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

Fehler

{"ok":false,"family":"auth","correlation_id":"…"}
  • 401 auth — Schlüssel fehlt oder ist ungültig.
  • 402 abbonamento — Abonnement inaktiv oder abgelaufen.
  • 403 accesso — Dein Tarif enthält keinen API-Zugang.
  • 429 quota — Die Grenze für Anfragen ist erreicht; versuche es nach dem angegebenen Intervall erneut. · Retry-After
  • 400 invalid_input — Ungültige Parameter.
  • 404 not_found — Ressource nicht gefunden.