Passa al contenuto principale

Appendix B. Using Problem Details with Other Formats (Utilizzo dei dettagli del problema con altri formati)

In alcune situazioni, può essere vantaggioso incorporare i dettagli del problema in formati diversi da quelli descritti qui. Ad esempio, un'API che utilizza HTML [W3C.REC-html5-20141028] potrebbe voler utilizzare anche HTML per esprimere i dettagli del problema.

I dettagli del problema possono essere incorporati in altri formati incapsulando una delle serializzazioni esistenti (JSON o XML) in quel formato o traducendo il modello di un dettaglio del problema (come specificato nella Sezione 3) nelle convenzioni del formato.

Ad esempio, in HTML, un problema potrebbe essere incorporato incapsulando JSON in un tag script:

<script type="application/problem+json">
  {
   "type": "https://example.com/probs/out-of-credit",
   "title": "You do not have enough credit.",
   "detail": "Your current balance is 30, but that costs 50.",
   "instance": "/account/12345/msgs/abc",
   "balance": 30,
   "accounts": ["/account/12345",
                "/account/67890"]
  }
</script>

o inventando una mappatura in RDFa [W3C.REC-rdfa-core-20130822].

Questa specifica non fornisce raccomandazioni specifiche riguardo all'incorporazione dei dettagli del problema in altri formati; il modo appropriato per incorporarli dipende sia dal formato in uso che dall'applicazione di quel formato.

Ringraziamenti (Acknowledgements)​

Gli autori desiderano ringraziare Jan Algermissen, Subbu Allamaraju, Mike Amundsen, Roy Fielding, Eran Hammer, Sam Johnston, Mike McCall, Julian Reschke e James Snell per la revisione di questa specifica.

Indirizzi degli autori (Authors' Addresses)​

Mark Nottingham
Akamai

Email: [email protected]
URI: https://www.mnot.net/

Erik Wilde

Email: [email protected]
URI: http://dret.net/netdret/

Ultimo aggiornamento il