I used to think it was a good idea that the API covers all possible outcomes from any calls to it.
But I don't know why I thought documenting the 500 errors was worth it. It's never an expected error, and if it happens, it's usually not something the client (as in, the person making use of the eCommerce application within their browser) would have anything to do or help with.
It's going to be better off the spec, to reduce complexity and clutter.
I used to think it was a good idea that the API covers all possible outcomes from any calls to it. But I don't know why I thought documenting the 500 errors was worth it. It's never an expected error, and if it happens, it's usually not something the client (as in, the person making use of the eCommerce application within their browser) would have anything to do or help with.
It's going to be better off the spec, to reduce complexity and clutter.