search

RubenVerborgh / solid-architecture

Drafts on the intended architecture of a concrete implementation of Solid
9 stars 3 forks source link

4xx error handling #4

Closed dsebastien closed 5 years ago

dsebastien commented 5 years ago

Just an idea that popped while i was reading https://github.com/solid/solid-architecture/blob/master/server/request-flow.md.

https://tools.ietf.org/html/rfc7807 is pretty neat to standardize/structure error messages returned to clients and make it easier for them to interpret/handle the error details.

In a recent project, we integrated it and we found it really beneficial. You can find some docs and examples here (we've gone a bit further than what the RFC initially covered):

RubenVerborgh commented 5 years ago

Did you mean https://tools.ietf.org/html/rfc7807 ?

csarven commented 5 years ago

@RubenVerborgh They use both RFCs AFAICT: https://github.com/NationalBankBelgium/REST-API-Design-Guide/wiki/Error-handling-Error-details#representation

dsebastien commented 5 years ago

Indeed rfc7807. I've picked the wrong link :)

RubenVerborgh commented 5 years ago

Indeed, seems like a good idea; I would just slap a JSON-LD context on there (and do conneg so we can have it in multiple formats).