apis: the ugly
DESCRIPTION
PTRANSCRIPT
APIs:The good, the bad, the ugly
@MicheleTitolo
Documentation?
“Send GET to /remove to delete”
JSON containing HTML
Authentication
Cookies
Authorization?
goto fail;
• “An error occured”
• “Oops”Errors
Unstable
Caching
Versioning
Breaking Changes
Testing?
Testing
Ugly APIsDon’t follow conventions
Ugly APIsare not intentionally ugly
Ugly APIsare a result of communication problems
and therefore can be fixed