API της Aralda

Δες διαγωνισμούς, προθεσμίες, φίλτρα και πηγές από τα εργαλεία σου μέσω του API.

Ταυτοποίηση

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

Το πλήρες κλειδί εμφανίζεται μόνο μία φορά. Κάνε ένα αντίγραφο και αποθήκευσε το κλειδί με ασφάλεια. Μην το μοιράζεσαι.

Κλειδιά API

Όρια ανά πρόγραμμα

ΠρόγραμμαΑιτήματα ανά ημέραΑιτήματα ανά λεπτόΑποτελέσματα ανά σελίδαΜέγιστη μετατόπιση
Κυνηγός2003025500
Συντεχνία20.00012010010.000
Δάσκαλος2.00030502.500
Προγράμματα και τιμές

Διαθέσιμες διαδρομές

GET /search

Αναζήτησε διαγωνισμούς με λέξεις, χώρα, CPV, αγοραστή και προθεσμία.

Παράμετροι: 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}

Στοιχεία διαγωνισμού μέσω ID.

Παράμετροι: id (UUID)

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

GET /deadlines

Ανοιχτοί διαγωνισμοί ταξινομημένοι κατά προθεσμία.

Παράμετροι: 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

Λίστα των αποθηκευμένων φίλτρων σου.

Παράμετροι: —

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

GET /filters/{id}/new

Νέοι διαγωνισμοί για το φίλτρο σου· η πρώτη κλήση καλύπτει τις τελευταίες 7 ημέρες και έπειτα ενημερώνει την τελευταία προβολή.

Παράμετροι: id (UUID)

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

GET /sources

Λίστα των ενεργών πηγών και της άδειάς τους.

Παράμετροι: —

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

Σφάλματα

{"ok":false,"family":"auth","correlation_id":"…"}
  • 401 auth — Το κλειδί λείπει ή δεν είναι έγκυρο.
  • 402 abbonamento — Η συνδρομή είναι ανενεργή ή έχει λήξει.
  • 403 accesso — Το πρόγραμμά σου δεν περιλαμβάνει πρόσβαση API.
  • 429 quota — Το όριο αιτημάτων συμπληρώθηκε· δοκίμασε ξανά μετά το καθορισμένο διάστημα. · Retry-After
  • 400 invalid_input — Μη έγκυρες παράμετροι.
  • 404 not_found — Ο πόρος δεν βρέθηκε.