APIdays Mediterranea 2015 Presentation exploring the API Discovery and how things can improve in the future once the whole process becomes automated.

1. how to automate
Bruno Pedro
5/6/2015
API Discovery

2. API Discovery is
a combination of
pure luck and
word-of-mouth.
@bpedro
https://twitter.com/bpedro/status/595952404513849345

3. Searching…

4. Reading
docu-
mentation

5. Signing up

6. Implementing

7. Integrating

8. benefit
cost
Automation
?

9. benefit
cost
sea
rch
Automation

10. benefit
cost
d
ocu
m
en
tation
Automation

11. benefit
cost
p
rov
ision
in
g
Automation

12. benefit
cost
cod
e
Automation

13. benefit
cost
Automation
+
in
teg
ration

14. benefit
cost
sea
rch
p
rov
ision
in
g
d
ocu
m
en
tation
cod
e
Automation
in
teg
ration

15. Machine-readability
Human Documentation
Endpoint Description
Pricing Information
Signup Instructions
…
{APIs.json

16. Machine-readability

17. Machine-readability
On-the-fly code
CapabilitiesPricing
License
Provisioning Automated Testing

18. Resources
• ProgrammableWeb APIs Directory:
http://www.programmableweb.com/apis/
directory
• Mashape: https://www.mashape.com/
• APIs.io: http://apis.io/
• Exicon APIs Directory:
https://app.exiconglobal.com/api-dir/
• Google APIs Discovery Service:
https://developers.google.com/discovery/
• readme.io: http://readme.io/
• Mashery: http://www.mashery.com/
• APIBlueprint: https://apiblueprint.org/
• Swagger: http://swagger.io/
• OAuth 2.0: https://tools.ietf.org/html/rfc6749
• SAML: http://saml.xml.org/saml-specifications
• SAML: http://saml.xml.org/saml-specifications
• Box Provision Grant:
https://developers.box.com/provision/
• REST United: http://restunited.com/
• SDKs.io: https://sdks.io/
• APIMatic: https://apimatic.io/
• Paw: https://luckymarmot.com/paw
• Runscope: https://www.runscope.com/
• POSTMAN: https://www.getpostman.com/
• API Changelog:
https://www.apichangelog.com/

19. how to automate
Bruno Pedro
@bpedro
API Discovery
Questions?