openknowledgebe / open-education

Website for Open Education (working group)
MIT License
3 stars 0 forks source link

[API] Remove response status section #18

Open RubenVerborgh opened 7 years ago

RubenVerborgh commented 7 years ago

The "response status" section just repeats the HTTP specification and does so in an incorrect way. (For instance, 200 does not mean "the request is valid".)

I suggest to remove this section and to point to the HTTP specification.

Possibly, a list of expected status codes can be given, and—more importantly than an explanation—how they can be fixed.