API Aralda

Consultez les appels d’offres, échéances, filtres et sources depuis vos outils grâce à l’API.

Authentification

https://api.aralda.com/v1

Authorization: Bearer arla_…

La clé complète n’est affichée qu’une fois. Copiez-la et conservez-la en lieu sûr : ne la partagez pas.

Forfait	Requêtes par jour	Requêtes par minute	Résultats par page	Décalage maximal
Chasseur	200	30	25	500
Guilde	20 000	120	100	10 000
Maître	2 000	30	50	2 500

Recherche d’appels d’offres par mots-clés, pays, CPV, acheteur et échéance.

Paramètres: 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_…'

Détails d’un appel d’offres par ID.

Paramètres: id (UUID)

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

Appels d’offres ouverts classés par échéance.

Paramètres: 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_…'

Liste de vos filtres enregistrés.

Paramètres: —

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

Nouveaux appels d’offres pour votre filtre ; le premier appel couvre les 7 derniers jours, puis actualise la dernière consultation.

Paramètres: id (UUID)

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

Liste des sources actives et de leur licence.

Paramètres: —

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

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

401 auth — Clé absente ou invalide.
402 abbonamento — Abonnement inactif ou expiré.
403 accesso — Votre forfait ne comprend pas l’accès API.
429 quota — Limite de requêtes atteinte ; réessayez après le délai indiqué. · Retry-After
400 invalid_input — Paramètres invalides.
404 not_found — Ressource introuvable.