scaling api design @restfest
Post on 31-Jan-2015
179 Views
Preview:
DESCRIPTION
TRANSCRIPT
© 2014 PayPal Inc. All rights reserved. Confidential and proprietary.
Scaling API Design
Jason Harmon, Head of API DesignSeptember 2014
© 2014 PayPal Inc. All rights reserved. Confidential and proprietary.
2
About meScaling API Design
Jason Harmon
• Leads API design at Paypal
• Design phase of the “PPaaS” aka “Paypal as a Service" program
• Engineering-wide initiative
• Collaborate on designs for all internal/external/partner/whatever APIs
• Maintain style/standards
• Stakeholder for internal developer portal & tools teams
• Internal API design training/evangelism
@jharmn
Jasonh-n-austin
© 2014 PayPal Inc. All rights reserved. 3
Let’s think bigWhat if your startup takes off?
© 2014 PayPal Inc. All rights reserved. 4
Distributed architectureEveryone starts with a monolith
© 2014 PayPal Inc. All rights reserved. 5
Portfolio is platform productThink in capabilities first
© 2014 PayPal Inc. All rights reserved. 6
Respect customer languageThink about the big picture; nouns matter
© 2014 PayPal Inc. All rights reserved. 7
Inverse Conway ManeuverMake your software look like your customers see you
“Organizations which design systems are constrained to produce designs which are copies of the communication structures of
these organizations.”
© 2014 PayPal Inc. All rights reserved. 8
Design firstRight after portfolio
© 2014 PayPal Inc. All rights reserved. 9
Mock itBreak it before you build it
© 2014 PayPal Inc. All rights reserved. 10
Design first: Parallelize
© 2014 PayPal Inc. All rights reserved. 11
Design principlesSustainability
APIUX: http://apiux.com/2014/09/05/api-design-sustainability
© 2014 PayPal Inc. All rights reserved. 12
Design principlesUsability
http://softexpert.files.wordpress.com/2007/10/52660486_6ca085f7a8.jpg?w=780
© 2014 PayPal Inc. All rights reserved. 13
Design principlesScalability
https://img1.etsystatic.com/000/0/5414982/il_fullxfull.191894533.jpg
© 2014 PayPal Inc. All rights reserved. 14
Design principlesConsistency
http://minorcreations.files.wordpress.com/2012/07/one.png
© 2014 PayPal Inc. All rights reserved. 15
EducationDecentralize through learning
© 2014 PayPal Inc. All rights reserved. Confidential and proprietary.
16
Thanks!
Jason Harmon
Head of API Design
Paypal
@jharmn
Jasonh-n-austin
Scaling API Design
top related