Maintainable consumers
Upcoming SlideShare
Loading in...5
×
 

Like this? Share it with your network

Share

Maintainable consumers

on

  • 455 views

Slides of my talk at the API Strategy & Practice Conference Amsterdam 2014.

Slides of my talk at the API Strategy & Practice Conference Amsterdam 2014.

Statistics

Views

Total Views
455
Views on SlideShare
453
Embed Views
2

Actions

Likes
0
Downloads
0
Comments
0

2 Embeds 2

https://twitter.com 1
https://www.linkedin.com 1

Accessibility

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

Maintainable consumers Presentation Transcript

  • 1. 26 March 2014 Bruno Pedro Maintainable Consumers
  • 2. Bruno Pedro Web and Cloud Computing Technologist with over ten years’ experience. CTO of GetApp. Editor at APIUX.com. http://brunopedro.com/
  • 3. Summary • What is a maintainable consumer • Factors that influence maintainability • Defending your implementation • Reacting to changes
  • 4. Maintainable • prevent unexpected downtime • identify and correct problems • maximize efficiency and reliability
 • cope with changes
  • 5. API Documentation
  • 6. Your Own Consumer vs SDK
  • 7. Unit and Integration Tests
  • 8. Alerts
  • 9. Documentation changes • Get notified by the provider • twitter • email
 • API Changelog • alerts by email
  • 10. Documentation changes • API Changelog • email alerts, RSS and JSON feeds
 
 
 
 
 

  • 11. Implement a Façade
  • 12. Consumer Generation • collection
 
 
 • markdown
 
 
 • functionsnodeunit
  • 13. Tests • POSTMAN Collection Runner
 
 
 
 
 
 
 

  • 14. Tests • Runscope Radar
 
 
 
 
 
 
 

  • 15. Reacting to changes • Technical changes • detected through tests • implement fix
 • e.g. invalid certificate, changed authorization layer, etc.
  • 16. Reacting to changes • Functional changes • harder to detect • don’t change the Façade • implement fix on the service layer • if not possible to fix, implement new methods
  • 17. Summary • Write code that can cope with changes • Evaluate API Documentation • Write unit and integration tests • Get alerts when things break
  • 18. Questions?
  • 19. 26 March 2014 Bruno Pedro Maintainable Consumers