Should we formalize JSend for API responses?

[siemensikkema]

Looking into our API guidelines and wondering why we should return 200 + {"status": "ok"} when there is no data (eg. for DELETE) instead of using 204 with an empty body I found this (JSend).
The guidelines mostly already follow this (except for "ok" instead of "success"). It does not seem to be an official spec but "success" pops up everywhere I find it mentioned.

I see 3 options:

• change nothing
• mention JSend
• mention JSend and change "ok" to "success"

What do you think?

@steffendsommer

[siemensikkema]

Actually, looking into it a bit more there are many more differences. We don't always return a "status" value and we don't wrap our responses under a "data" key. Also error handling is different.