A review of tools that can be used to design APIs, understand how API design works and to mock infrastructure to test your assumptions. We all know that a happy developer is a powerful ally. The focus of this presentation is on the creation of APIs with the support of tools to achieve this. The goal is to create APIs that are simple for developers to understand and consume, powerful enough to be maintained by your business, in minutes rather than hours.

1. Tools for building APIs

2. We ❤️ APIs

3. UNIREST

4. APIAnalytics.com
(Private Beta)

5. ?
What makes a good API?

6. Ǧ
Easy to learn

7. DŽ
Hard to misuse

8. Easy to read and maintain code that uses it

9. Easy to extend

10. Appropriate to audience

11. https://xkcd.com/1481/

12. ?
So..how do I design an API again?

13. Focus on developer experience

14. ǜ
Pick your (modelling) weapon of choice

15. ǜ
PRO-TIP: It’s whatever works for you

16. Collaborate and share API blueprints

17. Healthy Design Practices for APIs

18. ƭ
API Lifecycle: Design to Documentation

20. ƭ
Design and Document

21. API Studio (RAML)
API Designer
API Console
API Notebook

22. File browser
Editor
Quick Endpoint viewer

23. Endpoint Listing

24. Endpoint Details

25. Response Details

26. Test Console

27. Notebook

28. Overall
User friendliness: ★★☆☆☆
Flexibility: ★★★★★

29. APIARY(API Blueprint)
Documentation
Traffic Inspector
Editor

30. API Designer (Editor)

31. Documentation Explorer

32. User friendliness: ★★★★☆
Flexibility: ★★★★★
Overall

33. SWAGGER (YAML/JSON)
SWAGGER UI
SWAGGER EDITOR
SWAGGER CODEGEN

34. API Designer (Editor)

35. Documentation Explorer

36. User friendliness: ★★★★☆
Flexibility: ★★★★★
Overall

37. MASHAPE Docs

38. MASHAPE DOCS
A one page doc editor

39. MASHAPE DOCS
A one page doc editor

40. User friendliness: ★★★★☆
Flexibility: ★★★★★
Overall

41. RESTLET STUDIO

42. RESTLET STUDIO
Scaffolding your mock infrastructure with a nice UI

43. Other interesting tools

44. MOCARONI
Documentation
Mock API

46. README.IO
Documentation of all kinds

47. Setting up an API definition

48. APIMATIC
High quality SDK Generation

49. APIMATIC

50. RESTUNITED

52. ž
What’s on the other side?

53. Stay Frosty!
orlando@mashape.com
@orliesaurus