OpenAPI e Swagger: Guida Completa alle API e al Design di Interfacce di Programmazione

Negli ultimi anni, l’esplosione del modello architetturale basato sui microservizi ha reso le API (Application Programming Interface) un elemento centrale nello sviluppo software. Per garantire l’interoperabilità, la documentazione e la progettazione delle API sono diventate essenziali. Due strumenti chiave in questo panorama sono OpenAPI e Swagger, che hanno rivoluzionato il modo in cui gli sviluppatori […]

Swagger in .NET 6, Patch e ContractResolver

Utilizzando il verb Patch all’interno di una WebApi, utilizzando JsonPatchDocument come argomento ci si imbatte in un problema piuttosto noioso all’interno di Swagger. Quello che succedere è che Swagger non in grado di riconoscere automaticamente la classe che dovrà essere utilizzata di JsonPatchDocument, mostrando a video non lo lo schema della chiamata, ma contractResolver[]: Il […]

Configurare Swagger con Bearer Token

In .Net Core quando vengono create delle API protette con Bearer Token è necessario generare il token ed utilizzarlo all’interno dell’header delle chiamate alle API protette. Ad esempio, ci si potrebbe trovare nello scenario in cui il token viene generato tramite un’API dedicata al login, e successivamente lo si utilizza per le chiamate alle API […]

Swagger Tools per documentare Api DotNet Core

Scrivere una buona documentazione per un API consente di comprenderne facilmente le funzionalità e le modalità di utilizzo. Spesso la riscrittura della documentazione viene effettuata manualmente. Esistono numerosi sistemi che consentono di automatizzare le operazioni di scrittura della documentazione: uno di questi è Swagger/OpenApi. A partire da una descrizione dell’ API, i tool automatici consentono […]

Dotnet Core – Documentazione con Swagger

Scrivere la documentazione delle API di un’applicazione è spesso considerata un’operazione dispendiosa in termini di risorse e tempo. Nel corso degli anni sono stati sviluppati numerosi tools che consentono di creare la documentazione a partire dal codice sorgente, in maniera più o meno automatica.