Add guidance on providing standard response types

interagent / http-api-design

HTTP API design guide extracted from work on the Heroku Platform API

Other

13.69k stars 1.07k forks source link

Closed jessieay closed 5 years ago

jessieay commented 5 years ago

Returning an empty array rather than NULL helps consumers avoid conditionals.
Duck types FTW
Except for NULL, I guess
This came up when I learned that Oj parses BigDecimals as Strings. Seemed like bad API design to sometimes return a Number and sometimes return a String but this idea had not been articulated in the HTTP Design Guide.

geemus commented 5 years ago

Looks great, thanks for taking the time to write up and share!