APIs: The Ugly

20
APIs: The good, the bad, the ugly @MicheleTitolo

description

P

Transcript of APIs: The Ugly

Page 1: APIs: The Ugly

APIs:The good, the bad, the ugly

@MicheleTitolo

Page 2: APIs: The Ugly

Documentation?

Page 3: APIs: The Ugly

“Send GET to /remove to delete”

Page 4: APIs: The Ugly

JSON containing HTML

Page 5: APIs: The Ugly
Page 6: APIs: The Ugly

Authentication

Page 7: APIs: The Ugly

Cookies

Page 8: APIs: The Ugly
Page 9: APIs: The Ugly

Authorization?

goto fail;

Page 10: APIs: The Ugly

• “An error occured”

• “Oops”Errors

Page 11: APIs: The Ugly
Page 12: APIs: The Ugly

Unstable

Page 13: APIs: The Ugly

Caching

Page 14: APIs: The Ugly

Versioning

Page 15: APIs: The Ugly

Breaking Changes

Page 16: APIs: The Ugly

Testing?

Page 17: APIs: The Ugly

Testing

Page 18: APIs: The Ugly

Ugly APIsDon’t follow conventions

Page 19: APIs: The Ugly

Ugly APIsare not intentionally ugly

Page 20: APIs: The Ugly

Ugly APIsare a result of communication problems

and therefore can be fixed