openlibraryenvironment/gokb

General about REST Services

Closed this issue · 1 comments

At this time every REST request gives a 200 - most of the time - when sometimes there has been an error and it should return a status <> 200. Maybe we could follow this suggestions:

"Use HTTP Response Codes to Indicate Status" in
https://www.restapitutorial.com/lessons/restquicktips.html

also here at the end: https://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api#restful

Also it would be a good idea to inform the user of the API in detail about the problems or what he has done wrong. This can be very helpful for both sides of the API finding the error and solve the problems. Those details can be shorten in production code, means no stack trace and the like.