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