API da Aralda

Consulta concursos, prazos, filtros e fontes nas tuas ferramentas através da API.

Autenticação

https://api.aralda.com/v1

Authorization: Bearer arla_…

A chave completa é mostrada apenas uma vez. Copia-a e guarda-a em segurança: não a partilhes.

Plano	Pedidos por dia	Pedidos por minuto	Resultados por página	Deslocamento máximo
Caçador	200	30	25	500
Grémio	20.000	120	100	10.000
Mestre	2.000	30	50	2.500

Pesquisa concursos por palavras, país, CPV, comprador e prazo.

Parâmetros: 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_…'

Detalhes de um concurso através do ID.

Parâmetros: id (UUID)

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

Concursos abertos ordenados pelo prazo.

Parâmetros: 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 dos teus filtros guardados.

Parâmetros: —

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

Novos concursos para o teu filtro; a primeira chamada abrange os últimos 7 dias e depois atualiza a última consulta.

Parâmetros: id (UUID)

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

Lista das fontes ativas e da sua licença.

Parâmetros: —

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

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

401 auth — Chave ausente ou inválida.
402 abbonamento — Subscrição inativa ou expirada.
403 accesso — O teu plano não inclui acesso à API.
429 quota — Limite de pedidos atingido; tenta novamente após o intervalo indicado. · Retry-After
400 invalid_input — Parâmetros inválidos.
404 not_found — Recurso não encontrado.