OpenAPI 3.1 compliant
La specifica completa è disponibile in formato YAML e JSON. Può generare SDK tipizzati per TypeScript, Python, Go e Java con un singolo comando via openapi-generator o Speakeasy.
API
Un'API progettata per vivere in produzione per anni
Contratti stabili, deprecazioni annunciate con almeno dodici mesi di anticipo e un changelog pubblico aggiornato ad ogni release.
Principi
Stabilità come valore tecnico
Un'API che cambia senza preavviso è un debito tecnico che il suo team paga ogni sprint.
L'API REST di Costa & Ferrari segue principi HATEOAS parziali: ogni risposta include link alle risorse correlate, così il client deve conoscere solo l'endpoint radice per navigare l'intero grafo. Il versionamento avviene nel percorso URL — /v1/, /v2/ — e le versioni vengono mantenute in parallelo durante i periodi di transizione. Il team riceve notifiche via email e webhook almeno dodici mesi prima di qualsiasi sunset. Nei primi tre anni di operatività abbiamo rilasciato una sola versione maggiore e zero breaking change non annunciati.
Specifiche tecniche dell'API
Dettagli che il suo team deve conoscere prima dell'integrazione.
Rate limiting granulare
Limiti configurabili a livello di chiave API, tenant e piano tariffario. Le risposte 429 includono header Retry-After e X-RateLimit-Reset in formato Unix timestamp per una gestione automatica del backoff.
Multi-regione EU
I dati sono elaborati e conservati esclusivamente in datacenter europei certificati ISO 27001. Nessun trasferimento extra-UE dei payload delle richieste, in conformità con il GDPR.
«Abbiamo migrato da un provider americano a Costa & Ferrari principalmente per la conformità GDPR e non siamo tornati indietro. L'API è più stabile, il changelog è trasparente e il team di supporto capisce cosa significa zero-downtime deployment.»
Federica Russo, Lead Engineer — Milano
La specifica OpenAPI è disponibile adesso, gratuitamente
Scarichi il file YAML, generi il suo SDK e valuti la compatibilità con il suo stack prima di qualsiasi impegno commerciale.
Scarichi la specifica