SlideShare a Scribd company logo
1 of 30
Get Some REST
The why and how of great APIs
Allen Pike, Steamclock Software
APIs in 2013
Great APIs are table
stakes
• UI is for users
• API is for developers
• They need to be clear, fast and
easy
Mobile Platforms
APIs are spreading
APIs are restricting
Different models,
different APIs
different APIs
• Up front purchase
• Pure adoption
• A subscription SaaS
• API is the product
Help us help you
• Internal developers
• Consultants
• Partners
• Customers
• Fans
Building a great API
APIaaS
No surprises please
• Consistent
• Standard
• Plain
• Boring
#!QOX!#
on,361926297#!QOX!#Daniel Burka,Google Ventu
o-founder,@apike,917292#!QOX!#Tobias Lütke,S
ae,29817237#!QOX!#Robert Scoble,Rackspace,St
utsol,500px,CEO,@oleggutsol,103872#!QOX!#Ell
ngh,Tempo AI,CEO
Enter REST
• REpresentational State Transfer
• The modern best practice
• Uniform methods, no surprises
• Contrasts with SOAP RPC
vinaysahni.com/best-practices-for-a-pragmatic-
restful-api
RESTing up
• GET,POST,PUT,PATCH,DELETE
• Embraces HTTP
• Explorable with simple tools
• Fundamentally scalable
JSON
{ "XML": [ "Verbose",
"Heavy Handed",
"Overkill" ], "JSON": [
"Human Readable",
"Lightweight", "The new gold
standard" ]}
The magic formula
JSON
gzip
https
Care and feeding
Future proof your
API
• Always version
• Sometimes you release a bad
API
• New versions mark breaking
changes
• Deprecate and document
Support your API
• Documentation is just the seed
• Blog for news
• Forums and Stack Overflow for
help
• Intercom.io for actual support
Drive adoption
• Promote novel API uses
• Fund hackathons and
sponsorships
• SEO
• Double down on examples and
docs
• Royal decree
Recap• APIs are crucial
• Follow standard REST design
• Return JSON, gzipped, over
https
• Support with great
documentation
• Scale with versioning and
marketing
Go make great
things.
apike
steamclock.com
Get the slides here!

More Related Content

What's hot

Introduction to Continuous Delivery
Introduction to Continuous DeliveryIntroduction to Continuous Delivery
Introduction to Continuous Delivery
Hitesh Lad
 

What's hot (20)

Pain Points In API Development? They’re Everywhere
Pain Points In API Development? They’re EverywherePain Points In API Development? They’re Everywhere
Pain Points In API Development? They’re Everywhere
 
apidays LIVE Paris 2021 - Automating API Documentation by Ajinkya Marudwar, G...
apidays LIVE Paris 2021 - Automating API Documentation by Ajinkya Marudwar, G...apidays LIVE Paris 2021 - Automating API Documentation by Ajinkya Marudwar, G...
apidays LIVE Paris 2021 - Automating API Documentation by Ajinkya Marudwar, G...
 
Topo pal does2016
Topo pal does2016Topo pal does2016
Topo pal does2016
 
Auckland API & Microservices Meetup 1: API led design
Auckland API & Microservices Meetup 1: API led designAuckland API & Microservices Meetup 1: API led design
Auckland API & Microservices Meetup 1: API led design
 
Road to Black Friday 2015: How L.L.Bean Prepares for Traffic Spikes
Road to Black Friday 2015: How L.L.Bean Prepares for Traffic SpikesRoad to Black Friday 2015: How L.L.Bean Prepares for Traffic Spikes
Road to Black Friday 2015: How L.L.Bean Prepares for Traffic Spikes
 
JenniferBraschaykoPresentation
JenniferBraschaykoPresentationJenniferBraschaykoPresentation
JenniferBraschaykoPresentation
 
Introduction to Continuous Delivery
Introduction to Continuous DeliveryIntroduction to Continuous Delivery
Introduction to Continuous Delivery
 
Testing APIs & Microservices
Testing APIs & MicroservicesTesting APIs & Microservices
Testing APIs & Microservices
 
An agile introduction to DevOps
An agile introduction to DevOpsAn agile introduction to DevOps
An agile introduction to DevOps
 
TuleapCon 2017-STMicroelectronics-Case-Study
TuleapCon 2017-STMicroelectronics-Case-StudyTuleapCon 2017-STMicroelectronics-Case-Study
TuleapCon 2017-STMicroelectronics-Case-Study
 
The impact of IoT on APIs
The impact of IoT on APIsThe impact of IoT on APIs
The impact of IoT on APIs
 
Cireson Sessions: Asset Management
Cireson Sessions: Asset Management Cireson Sessions: Asset Management
Cireson Sessions: Asset Management
 
API Kompatibilität durch Consumer-Driven Contracts und CI/CD
API Kompatibilität durch Consumer-Driven Contracts und CI/CDAPI Kompatibilität durch Consumer-Driven Contracts und CI/CD
API Kompatibilität durch Consumer-Driven Contracts und CI/CD
 
Service fabric demo
Service fabric demoService fabric demo
Service fabric demo
 
APIs are not SOA++
APIs  are not SOA++APIs  are not SOA++
APIs are not SOA++
 
Demo: New open banking platform
Demo: New open banking platformDemo: New open banking platform
Demo: New open banking platform
 
Sparking Innovation With GitHub
Sparking Innovation With GitHubSparking Innovation With GitHub
Sparking Innovation With GitHub
 
Deep-Dive: How Can APIs Help You Innovate? (Partner Ecosystems)
Deep-Dive: How Can APIs Help You Innovate? (Partner Ecosystems)Deep-Dive: How Can APIs Help You Innovate? (Partner Ecosystems)
Deep-Dive: How Can APIs Help You Innovate? (Partner Ecosystems)
 
Turn On The Lights
Turn On The LightsTurn On The Lights
Turn On The Lights
 
TuleapCon2017-CaseStudy_Sleepinnov_Medical_Devices
TuleapCon2017-CaseStudy_Sleepinnov_Medical_DevicesTuleapCon2017-CaseStudy_Sleepinnov_Medical_Devices
TuleapCon2017-CaseStudy_Sleepinnov_Medical_Devices
 

Similar to Get Some REST: Building Great APIs for Great Apps | Allen Pike, Steamclock Software

STC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based ApproachSTC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based Approach
Lois Patterson
 
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Nordic APIs
 

Similar to Get Some REST: Building Great APIs for Great Apps | Allen Pike, Steamclock Software (20)

Lessons learned on the Azure API Stewardship Journey.pptx
Lessons learned on the Azure API Stewardship Journey.pptxLessons learned on the Azure API Stewardship Journey.pptx
Lessons learned on the Azure API Stewardship Journey.pptx
 
Make Your Contribution Count. Adding Value to the API as a Technical Communic...
Make Your Contribution Count. Adding Value to the API as a Technical Communic...Make Your Contribution Count. Adding Value to the API as a Technical Communic...
Make Your Contribution Count. Adding Value to the API as a Technical Communic...
 
apidays Australia 2022 - Accelerating API Engineering, Jason D'Souza & Andrew...
apidays Australia 2022 - Accelerating API Engineering, Jason D'Souza & Andrew...apidays Australia 2022 - Accelerating API Engineering, Jason D'Souza & Andrew...
apidays Australia 2022 - Accelerating API Engineering, Jason D'Souza & Andrew...
 
Building a REST API for Longevity
Building a REST API for LongevityBuilding a REST API for Longevity
Building a REST API for Longevity
 
apidays LIVE Paris 2021 - Lessons from the API Stewardship Journey in Azure b...
apidays LIVE Paris 2021 - Lessons from the API Stewardship Journey in Azure b...apidays LIVE Paris 2021 - Lessons from the API Stewardship Journey in Azure b...
apidays LIVE Paris 2021 - Lessons from the API Stewardship Journey in Azure b...
 
Practical Application of API-First in microservices development
Practical Application of API-First in microservices developmentPractical Application of API-First in microservices development
Practical Application of API-First in microservices development
 
STC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based ApproachSTC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based Approach
 
OracleDeveloperMeetup - London 19-12-17
OracleDeveloperMeetup - London 19-12-17OracleDeveloperMeetup - London 19-12-17
OracleDeveloperMeetup - London 19-12-17
 
Service api design validation & collaboration
Service api design validation & collaborationService api design validation & collaboration
Service api design validation & collaboration
 
apidays LIVE New York 2021 - Service API design validation by Uchit Vyas, KPMG
apidays LIVE New York 2021 - Service API design validation by Uchit Vyas, KPMGapidays LIVE New York 2021 - Service API design validation by Uchit Vyas, KPMG
apidays LIVE New York 2021 - Service API design validation by Uchit Vyas, KPMG
 
Effective API Design
Effective API DesignEffective API Design
Effective API Design
 
Your API is your Product - Arun Ravindran, Unisys
Your API is your Product - Arun Ravindran, UnisysYour API is your Product - Arun Ravindran, Unisys
Your API is your Product - Arun Ravindran, Unisys
 
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
 
How we use the play framework
How we use the play frameworkHow we use the play framework
How we use the play framework
 
The Ultimate API Publisher's Guide
The Ultimate API Publisher's GuideThe Ultimate API Publisher's Guide
The Ultimate API Publisher's Guide
 
SharePoint Fest Chicago - Introduction to AngularJS with the Microsoft Graph
SharePoint Fest Chicago - Introduction to AngularJS with the Microsoft GraphSharePoint Fest Chicago - Introduction to AngularJS with the Microsoft Graph
SharePoint Fest Chicago - Introduction to AngularJS with the Microsoft Graph
 
Pitney Bowes Uses Development and Testing Tools to Drive Early API Developmen...
Pitney Bowes Uses Development and Testing Tools to Drive Early API Developmen...Pitney Bowes Uses Development and Testing Tools to Drive Early API Developmen...
Pitney Bowes Uses Development and Testing Tools to Drive Early API Developmen...
 
apidays LIVE London 2021 - Confessions of a Product Geek by Rosemary Missier,...
apidays LIVE London 2021 - Confessions of a Product Geek by Rosemary Missier,...apidays LIVE London 2021 - Confessions of a Product Geek by Rosemary Missier,...
apidays LIVE London 2021 - Confessions of a Product Geek by Rosemary Missier,...
 
2018-10-23 3C - Lean, Scrum and low code approach of SharePoint and O365 proj...
2018-10-23 3C - Lean, Scrum and low code approach of SharePoint and O365 proj...2018-10-23 3C - Lean, Scrum and low code approach of SharePoint and O365 proj...
2018-10-23 3C - Lean, Scrum and low code approach of SharePoint and O365 proj...
 
INTERFACE, by apidays - The 8 Key Components of a Modern API Stack by Iddo G...
INTERFACE, by apidays  - The 8 Key Components of a Modern API Stack by Iddo G...INTERFACE, by apidays  - The 8 Key Components of a Modern API Stack by Iddo G...
INTERFACE, by apidays - The 8 Key Components of a Modern API Stack by Iddo G...
 

More from Dealmaker Media

More from Dealmaker Media (20)

GROWtalks - Grow Like an Olympian, Know What Fast Really Means - Brian Krausz
GROWtalks - Grow Like an Olympian, Know What Fast Really Means - Brian KrauszGROWtalks - Grow Like an Olympian, Know What Fast Really Means - Brian Krausz
GROWtalks - Grow Like an Olympian, Know What Fast Really Means - Brian Krausz
 
GROWtalks - Level Up your Engagement - Insider tips from a mobile games leade...
GROWtalks - Level Up your Engagement - Insider tips from a mobile games leade...GROWtalks - Level Up your Engagement - Insider tips from a mobile games leade...
GROWtalks - Level Up your Engagement - Insider tips from a mobile games leade...
 
GROWtalks - Designing with Data to Drive New Users - Stew Langille
GROWtalks - Designing with Data to Drive New Users - Stew LangilleGROWtalks - Designing with Data to Drive New Users - Stew Langille
GROWtalks - Designing with Data to Drive New Users - Stew Langille
 
GROWtalks - Content that Converts: Win Leads and Influence People - Lisa Manf...
GROWtalks - Content that Converts: Win Leads and Influence People - Lisa Manf...GROWtalks - Content that Converts: Win Leads and Influence People - Lisa Manf...
GROWtalks - Content that Converts: Win Leads and Influence People - Lisa Manf...
 
GROWtalks - Create a Dead Simple Process for Building Great Product - Michael...
GROWtalks - Create a Dead Simple Process for Building Great Product - Michael...GROWtalks - Create a Dead Simple Process for Building Great Product - Michael...
GROWtalks - Create a Dead Simple Process for Building Great Product - Michael...
 
Resource Code: Innovating the VC Firm with Platform & Community | Rob Hayes, ...
Resource Code: Innovating the VC Firm with Platform & Community | Rob Hayes, ...Resource Code: Innovating the VC Firm with Platform & Community | Rob Hayes, ...
Resource Code: Innovating the VC Firm with Platform & Community | Rob Hayes, ...
 
Innovation Spotlight: Anti-Robot | Jonathan Tippett (Industrialus Design), Da...
Innovation Spotlight: Anti-Robot | Jonathan Tippett (Industrialus Design), Da...Innovation Spotlight: Anti-Robot | Jonathan Tippett (Industrialus Design), Da...
Innovation Spotlight: Anti-Robot | Jonathan Tippett (Industrialus Design), Da...
 
The Age of Context: How it Will Change your Life & Work | Robert Scoble, Rack...
The Age of Context: How it Will Change your Life & Work | Robert Scoble, Rack...The Age of Context: How it Will Change your Life & Work | Robert Scoble, Rack...
The Age of Context: How it Will Change your Life & Work | Robert Scoble, Rack...
 
Thinking Big - No, Bigger | Pablos Holman
Thinking Big - No, Bigger | Pablos HolmanThinking Big - No, Bigger | Pablos Holman
Thinking Big - No, Bigger | Pablos Holman
 
Lead by Design: Bringing Design Culture into the Industrial Internet Age | Gr...
Lead by Design: Bringing Design Culture into the Industrial Internet Age | Gr...Lead by Design: Bringing Design Culture into the Industrial Internet Age | Gr...
Lead by Design: Bringing Design Culture into the Industrial Internet Age | Gr...
 
The Intersection of Design and Entrepreneurial Thinking | Munjal Shah, Charle...
The Intersection of Design and Entrepreneurial Thinking | Munjal Shah, Charle...The Intersection of Design and Entrepreneurial Thinking | Munjal Shah, Charle...
The Intersection of Design and Entrepreneurial Thinking | Munjal Shah, Charle...
 
Innovation Spotlight: InteraXon | Ariel Garten, InteraXon
Innovation Spotlight: InteraXon | Ariel Garten, InteraXonInnovation Spotlight: InteraXon | Ariel Garten, InteraXon
Innovation Spotlight: InteraXon | Ariel Garten, InteraXon
 
3 Growth Hacks: The Secrets to Driving Massive User Growth | Josh Elman, Grey...
3 Growth Hacks: The Secrets to Driving Massive User Growth | Josh Elman, Grey...3 Growth Hacks: The Secrets to Driving Massive User Growth | Josh Elman, Grey...
3 Growth Hacks: The Secrets to Driving Massive User Growth | Josh Elman, Grey...
 
UX Design for Developers | Oleg Gutsol, 500px
UX Design for Developers | Oleg Gutsol, 500pxUX Design for Developers | Oleg Gutsol, 500px
UX Design for Developers | Oleg Gutsol, 500px
 
Big Picture CRO (Conversion Rate Optimization) | Rand Fishkin, Moz
Big Picture CRO (Conversion Rate Optimization) | Rand Fishkin, MozBig Picture CRO (Conversion Rate Optimization) | Rand Fishkin, Moz
Big Picture CRO (Conversion Rate Optimization) | Rand Fishkin, Moz
 
Quality Over Quantity - Mobile Users Mater | Jarah Euston, Flurry
Quality Over Quantity - Mobile Users Mater | Jarah Euston, FlurryQuality Over Quantity - Mobile Users Mater | Jarah Euston, Flurry
Quality Over Quantity - Mobile Users Mater | Jarah Euston, Flurry
 
GROWtalks - UX + Lean = Awesome
GROWtalks - UX + Lean = AwesomeGROWtalks - UX + Lean = Awesome
GROWtalks - UX + Lean = Awesome
 
GROWtalks - 10 Metrics You Need to be Tracking - Neil Patel KISSmetrics
GROWtalks - 10 Metrics You Need to be Tracking - Neil Patel KISSmetricsGROWtalks - 10 Metrics You Need to be Tracking - Neil Patel KISSmetrics
GROWtalks - 10 Metrics You Need to be Tracking - Neil Patel KISSmetrics
 
GROWtalks - Couples Counseling for Software Development - Joe Stump Sprint.ly
GROWtalks - Couples Counseling for Software Development - Joe Stump Sprint.lyGROWtalks - Couples Counseling for Software Development - Joe Stump Sprint.ly
GROWtalks - Couples Counseling for Software Development - Joe Stump Sprint.ly
 
GROWtalks - Better Insights for Faster Growth - Sean Ellis Qualaroo
GROWtalks - Better Insights for Faster Growth - Sean Ellis QualarooGROWtalks - Better Insights for Faster Growth - Sean Ellis Qualaroo
GROWtalks - Better Insights for Faster Growth - Sean Ellis Qualaroo
 

Recently uploaded

Histor y of HAM Radio presentation slide
Histor y of HAM Radio presentation slideHistor y of HAM Radio presentation slide
Histor y of HAM Radio presentation slide
vu2urc
 
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptxEIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
Earley Information Science
 

Recently uploaded (20)

GenAI Risks & Security Meetup 01052024.pdf
GenAI Risks & Security Meetup 01052024.pdfGenAI Risks & Security Meetup 01052024.pdf
GenAI Risks & Security Meetup 01052024.pdf
 
Histor y of HAM Radio presentation slide
Histor y of HAM Radio presentation slideHistor y of HAM Radio presentation slide
Histor y of HAM Radio presentation slide
 
A Domino Admins Adventures (Engage 2024)
A Domino Admins Adventures (Engage 2024)A Domino Admins Adventures (Engage 2024)
A Domino Admins Adventures (Engage 2024)
 
08448380779 Call Girls In Friends Colony Women Seeking Men
08448380779 Call Girls In Friends Colony Women Seeking Men08448380779 Call Girls In Friends Colony Women Seeking Men
08448380779 Call Girls In Friends Colony Women Seeking Men
 
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
 
How to convert PDF to text with Nanonets
How to convert PDF to text with NanonetsHow to convert PDF to text with Nanonets
How to convert PDF to text with Nanonets
 
GenCyber Cyber Security Day Presentation
GenCyber Cyber Security Day PresentationGenCyber Cyber Security Day Presentation
GenCyber Cyber Security Day Presentation
 
From Event to Action: Accelerate Your Decision Making with Real-Time Automation
From Event to Action: Accelerate Your Decision Making with Real-Time AutomationFrom Event to Action: Accelerate Your Decision Making with Real-Time Automation
From Event to Action: Accelerate Your Decision Making with Real-Time Automation
 
Scaling API-first – The story of a global engineering organization
Scaling API-first – The story of a global engineering organizationScaling API-first – The story of a global engineering organization
Scaling API-first – The story of a global engineering organization
 
Partners Life - Insurer Innovation Award 2024
Partners Life - Insurer Innovation Award 2024Partners Life - Insurer Innovation Award 2024
Partners Life - Insurer Innovation Award 2024
 
How to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected WorkerHow to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected Worker
 
Raspberry Pi 5: Challenges and Solutions in Bringing up an OpenGL/Vulkan Driv...
Raspberry Pi 5: Challenges and Solutions in Bringing up an OpenGL/Vulkan Driv...Raspberry Pi 5: Challenges and Solutions in Bringing up an OpenGL/Vulkan Driv...
Raspberry Pi 5: Challenges and Solutions in Bringing up an OpenGL/Vulkan Driv...
 
Boost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivityBoost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivity
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
 
08448380779 Call Girls In Diplomatic Enclave Women Seeking Men
08448380779 Call Girls In Diplomatic Enclave Women Seeking Men08448380779 Call Girls In Diplomatic Enclave Women Seeking Men
08448380779 Call Girls In Diplomatic Enclave Women Seeking Men
 
ProductAnonymous-April2024-WinProductDiscovery-MelissaKlemke
ProductAnonymous-April2024-WinProductDiscovery-MelissaKlemkeProductAnonymous-April2024-WinProductDiscovery-MelissaKlemke
ProductAnonymous-April2024-WinProductDiscovery-MelissaKlemke
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptxEIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
EIS-Webinar-Prompt-Knowledge-Eng-2024-04-08.pptx
 
Automating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps ScriptAutomating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps Script
 
[2024]Digital Global Overview Report 2024 Meltwater.pdf
[2024]Digital Global Overview Report 2024 Meltwater.pdf[2024]Digital Global Overview Report 2024 Meltwater.pdf
[2024]Digital Global Overview Report 2024 Meltwater.pdf
 

Get Some REST: Building Great APIs for Great Apps | Allen Pike, Steamclock Software

Editor's Notes

  1. - I run Steamclock Software- At Steamclock, we build iOS, Android, and JavaScript apps - Our work has been featured by Apple, CNN, and Fast Company- Before founding Steamclock, I was a Software Engineer at Apple
  2. Triopoly No explosion of viable platformsNo one platform dominatesJavaScript apps increasingly consume APIs
  3. Sep 2012: Twitter restricts their APIMar 2013: Netflix restricts their APIJul 2013: Google cans ReaderWhat is going on?
  4. Twilio, Urban Airship, Stripe Github, dropbox Instapaper
  5. Great APIs lead to great apps
  6. Apple iCloud APIsDropbox APIParse (now owned by FB)Other APIs as a Service
  7. It was like an archeological dig The CTO had no idea this was happening
  8. Not a silver bullet, but at least bronze
  9. Some Enterprises will demand XML or other noise, but provide JSON by default
  10. it's cheap, it's secure, it's easy to support now saves time and bandwidth. Stack Overflow doesn't even accept GZIP off, this is becoming more common
  11. Story This is an alpha-stage platform built by a team of 3. The docs were so thoughtful that Justin trusted them immediately Docs are a marketing message
  12. Swagger is a tool and specification for generating API docs
  13. This is on the homepage of stripe.com. Hell yes. Show both a simple and a complex example
  14. Documentation needs to be googled Reasonable SEO No PDFs, no login walls
  15. Twilio is the top 3 results The #1 result is their REST API docs!
  16. Versions telegraph and enable change Sets the expectation that things may change
  17. Start by solving a problem
  18. APIs all the way down The Amazon SOA architecture