Endpoint
Lista, dettaglio e ricerca dei bandi con filtri per ATECO, regione, scadenza, fascia di finanziamento e spese ammissibili. Paginazione standard via limit/offset.
Documentazione API in arrivo
La specifica completa arriverà al lancio dell'API pubblica.
Stiamo preparando il riferimento OpenAPI con endpoint, schema dei bandi, autenticazione, webhook ed esempi di integrazione. Nel frattempo puoi esplorare la playground con dati reali e parlare con noi del tuo caso d'uso.
Riferimento APIOpenAPI 3.1
bandoeasy.openapi.yaml
openapi: 3.1.0
info:
title: Bando Easy API
version: 1.0.0
servers:
- url: https://api.bandoeasy.it/v1
paths:
/grants:
get:
summary: List grants
parameters:
- $ref: '#/components/parameters/ateco'
- $ref: '#/components/parameters/region'
- $ref: '#/components/parameters/status'Cosa includerà la documentazione
Tutto quello che serve per andare in produzione.
Riferimento completo per integrare i bandi italiani nel tuo prodotto: dalla prima chiamata fino al deploy con webhook e rate-limit gestiti correttamente.
Schema dei bandi
Tutti i campi e le relazioni che restituiamo: promotore, dotazione, scadenza, fondo perduto, codici ATECO 2025, settori, province, allegati, a-chi-si-rivolge.
Autenticazione
Bearer token via header Authorization. Chiavi sk_live e sk_test per produzione e sandbox. Restrizioni per IP e rotazione delle chiavi configurabili.
Webhook
Eventi bando.created, bando.updated, bando.deadline_approaching, sync.completed, sync.failed. Firma HMAC-SHA256 su ogni richiesta per verificare l'origine.
Errori e rate limit
Codici HTTP standard, payload di errore con campo motivo. Header X-RateLimit-* su ogni risposta. Quota giornaliera e mensile per chiave.
SDK ed esempi
Esempi pronti in Node.js, Python e cURL. SDK ufficiale @bandoeasy/sdk in arrivo con tipizzazione completa e helper per webhook.
Anteprima reale, non slide
Prova le chiamate API prima ancora che esca la spec.
La playground mostra il payload completo di un bando reale, sei varianti di filtri e proiezioni, e l'esatto JSON che riceverai in produzione.