10. Machine-readable docs
API version
Supported protocols
Method
Method
description
Link to response
description
required?
Argument type
API
characteristics
Method
characteristics
Response
Arguments
11. Would it be nice?
All APIs descriptions in one place
Documented in one format
Anyone can add/improve API description
12. What APIs.guru do?
Filter out private and non-reliable APIs.
Convert different formats into Swagger 2.0
Fix mistakes, ~80% of spec have them
Add additional data, like: logo, categories, …
19. Why not Hypermedia?
Cool technology, but doesn’t help iPaaS:
Can access metadata only after first call
Metadata only for particular entities
Require API owner to change implementation