API Aralda

Przeglądaj przetargi, terminy, filtry i źródła w swoich narzędziach przez API.

Uwierzytelnianie

https://api.aralda.com/v1

Authorization: Bearer arla_…

Pełny klucz jest wyświetlany tylko raz. Skopiuj go i przechowuj bezpiecznie: nie udostępniaj go.

Plan	Żądania dziennie	Żądania na minutę	Wyniki na stronę	Maksymalne przesunięcie
Łowca	200	30	25	500
Gildia	20 000	120	100	10 000
Mistrz	2000	30	50	2500

Wyszukuj przetargi według słów, kraju, CPV, zamawiającego i terminu.

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

Szczegóły przetargu według ID.

Parametry: id (UUID)

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

Otwarte przetargi uporządkowane według terminu.

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

Lista zapisanych filtrów.

Parametry: —

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

Nowe przetargi dla twojego filtra; pierwsze wywołanie obejmuje ostatnie 7 dni, a następnie aktualizuje czas ostatniego przeglądania.

Parametry: id (UUID)

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

Lista aktywnych źródeł i ich licencji.

Parametry: —

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

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

401 auth — Brak klucza lub klucz nieprawidłowy.
402 abbonamento — Subskrypcja nieaktywna lub wygasła.
403 accesso — Twój plan nie obejmuje dostępu do API.
429 quota — Osiągnięto limit żądań; spróbuj ponownie po wskazanym czasie. · Retry-After
400 invalid_input — Nieprawidłowe parametry.
404 not_found — Nie znaleziono zasobu.