search

fderrigo / api-starter-kit-aspnetcore

0 stars 3 forks source link

Domanda sulla classe Problem #2

Open Defkon1 opened 1 year ago

Defkon1 commented 1 year ago

Buongiorno,

avrei una domanda sulla classe Problem: come mai si è scelto di re-implementarla ex-novo anziché usare la standard Microsoft.AspNetCore.Mvc.ProblemDetails (che è comunque rispettosa della RFC7807)?

fderrigo commented 1 year ago

La classe è autogenerata dallo swagger editor. Per realizzare il codice di esempio si è partiti da un file di specifiche che puoi recuperare cliccando su "From template". da https://italia.github.io/api-oas-checker/

Come noterei è definito uno schema Problem:

  schemas:
    Problem:
      $ref: 'https://teamdigitale.github.io/openapi/0.0.7/definitions.yaml#/schemas/Problem'
Defkon1 commented 1 year ago

Grazie della precisazione, mi era sfuggito lo schema tra le definizioni...

in questo caso tuttavia potrebbe avere più senso creare una classe Problem che estende direttamente la ProblemDetails (in modo da non inserire ridondanze) o ci vedi limiti/problemi?

fderrigo commented 1 year ago

Nessun Limite o problema. lo starter kit vuole essere un esempio per scrivere api conformi alle Linee Guida sull’interoperabilità tecnica delle Pubbliche Amministrazioni fornite da AgID.

L'utilizzo di Microsoft.AspNetCore.Mvc.ProblemDetails è la soluzione ottimale