OpenAPI e Swagger (3): parametri, request body e schemas in Swagger UI

Giovanni Pace

Descrizione

In Swagger UI ogni chiamata è una simulazione reale, e per farla bene bisogna leggere il contratto: parametri, request body ed example value rispettano sempre uno schema. Proviamo una GET con parametro e una POST con body JSON sulla demo Petstore, rifacciamo la stessa POST in Postman e vediamo come nascono l'header Content-Type e la curl.

Cosa imparerai

  • La sezione Servers e la versione di OpenAPI dietro la UI
  • Come impostare un parametro di percorso con Try it out (GET pet per ID)
  • Perché copiare l'output nei tipi Angular è rischioso, e perché guardare lo schema
  • Come gli schemas si richiamano tra loro (Pet che punta a Category)
  • POST con request body obbligatorio: inserire un nuovo pet
  • La stessa POST in Postman con body raw JSON, header Content-Type e la curl generata