Download - Scaling API Design @restfest
![Page 1: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/1.jpg)
© 2014 PayPal Inc. All rights reserved. Confidential and proprietary.
Scaling API Design
Jason Harmon, Head of API DesignSeptember 2014
![Page 2: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/2.jpg)
© 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
![Page 3: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/3.jpg)
© 2014 PayPal Inc. All rights reserved. 3
Let’s think bigWhat if your startup takes off?
![Page 4: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/4.jpg)
© 2014 PayPal Inc. All rights reserved. 4
Distributed architectureEveryone starts with a monolith
![Page 5: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/5.jpg)
© 2014 PayPal Inc. All rights reserved. 5
Portfolio is platform productThink in capabilities first
![Page 6: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/6.jpg)
© 2014 PayPal Inc. All rights reserved. 6
Respect customer languageThink about the big picture; nouns matter
![Page 7: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/7.jpg)
© 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.”
![Page 8: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/8.jpg)
© 2014 PayPal Inc. All rights reserved. 8
Design firstRight after portfolio
![Page 9: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/9.jpg)
© 2014 PayPal Inc. All rights reserved. 9
Mock itBreak it before you build it
![Page 10: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/10.jpg)
© 2014 PayPal Inc. All rights reserved. 10
Design first: Parallelize
![Page 11: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/11.jpg)
© 2014 PayPal Inc. All rights reserved. 11
Design principlesSustainability
APIUX: http://apiux.com/2014/09/05/api-design-sustainability
![Page 12: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/12.jpg)
© 2014 PayPal Inc. All rights reserved. 12
Design principlesUsability
http://softexpert.files.wordpress.com/2007/10/52660486_6ca085f7a8.jpg?w=780
![Page 13: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/13.jpg)
© 2014 PayPal Inc. All rights reserved. 13
Design principlesScalability
https://img1.etsystatic.com/000/0/5414982/il_fullxfull.191894533.jpg
![Page 14: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/14.jpg)
© 2014 PayPal Inc. All rights reserved. 14
Design principlesConsistency
http://minorcreations.files.wordpress.com/2012/07/one.png
![Page 15: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/15.jpg)
© 2014 PayPal Inc. All rights reserved. 15
EducationDecentralize through learning
![Page 16: Scaling API Design @restfest](https://reader033.vdocuments.net/reader033/viewer/2022061300/54cc82f44a79597d4a8b45ca/html5/thumbnails/16.jpg)
© 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