SlideShare une entreprise Scribd logo
1  sur  69
Télécharger pour lire hors ligne
Your	
  API	
  Sucks	
  
Why	
  developers	
  hang	
  up	
  and	
  how	
  to	
  stop	
  that.	
  


Rapid	
  API	
  Workshop	
  


Marsh	
  Gardiner 	
            	
       	
  Brian	
  Mulloy	
  
@earth2marsh            	
       	
      	
  @landlessness	
  	
  
@earth2marsh   @landlessness
Rapid API Workshop Webinar Series

Mapping	
  out	
  your	
  API	
  Strategy	
  	
  
PragmaAc	
  REST:	
  API	
  Design	
  Fu	
  
10	
  PaJerns	
  of	
  Successful	
  API	
  Programs	
  
API	
  Metrics	
  –	
  What	
  to	
  Measure?	
  
API	
  Technology	
  &	
  OperaAons	
  
Today:	
  Your	
  API	
  Sucks!	
  
PCI	
  Compliance	
  and	
  APIs	
  
	
  
THIS TALK
IN A NUTSHELL
• 	
  User	
  experience	
  wins	
  
• 	
  API	
  users	
  =	
  developers	
  
• 	
  Developer	
  experiences	
  (generally)	
  suck	
  
• 	
  But	
  they	
  don’t	
  have	
  to…	
  
#betterapis!
Four simple rules

1. Give developers every reason to build
2. Make them successful faster
3. Don't violate their trust
4. Listen
Hangup Reason #1

Why would I use your API?
Why	
  did	
  you	
  
build	
  an	
  API?	
  
Four simple rules

1. Give developers every reason to build
2. Make them successful faster
3. Don't violate their trust
4. Listen
Simple	
  things	
  should	
  be	
  simple.	
  

Complex	
  things	
  should	
  be	
  possible.	
  

    	
     	
     	
     	
     	
     	
  —	
  Alan	
  Kay	
  
Krug says:
1. People don’t read pages. They scan them.
2. People don’t make optimal choices. They
   satisfice.
3. People don’t figure out how things work.
   They muddle through.
Hangup Reason #2

You’re making this too hard.
TTFR
 Time	
  
 To	
  
 First	
  
 Request	
  
Four simple rules

1. Give developers every reason to build
2. Make them successful faster
3. Don't violate their trust
4. Listen
Hangup Reason #3

Are you going to support me?
Four simple rules

1. Give developers every reason to build
2. Make them successful faster
3. Don't violate their trust
4. Listen
Your	
  API	
  is	
  a	
  product.	
  


Treat	
  it	
  that	
  way.	
  
Your	
  developers	
  are	
  your	
  customers.	
  
Why	
  is	
  this	
  so	
  hard?	
  
Why	
  does	
  Freemium	
  work?	
  
Do	
  it	
  beIer	
  
SOAP	
  
 POST /InStock HTTP/1.1
 Host: www.example.org
 Content-Type: application/soap+xml; charset=utf-8
 Content-Length: 299

 <?xml version="1.0"?>
 <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Header>
  </soap:Header>
  <soap:Body>
   <m:GetStockPrice xmlns:m="http://www.example.org/stock">
     <m:StockName>IBM</m:StockName>
   </m:GetStockPrice>
  </soap:Body>
 </soap:Envelope>
Why	
  REST	
  is	
  winning:	
  
http://api.twitter.com/1/statuses/public_timeline.json
Your	
  engineers	
  may	
  be	
  great	
  at	
  wriAng	
  the	
  
code	
  behind	
  your	
  API.	
  	
  


Are	
  they	
  great	
  at	
  designing	
  for	
  API	
  adop<on?	
  	
  
POST !
https://api.bluevia.com/services/
REST/Advertising_Sandbox/simple/
requests?version=v1!
Opacity	
  is	
  inscrutable.	
  (Also,	
  unforgivable.)	
  


Give	
  devs	
  the	
  informa<on	
  they	
  need	
  to	
  succeed.	
  
Good	
  PaIerns	
  
Put	
  yourself	
  in	
  their	
  shoes.	
  
Four simple rules

1. Give developers every reason to build
2. Make them successful faster
3. Don't violate their trust
4. Listen
Rapid API Workshop Webinar Series

Mapping	
  out	
  your	
  API	
  Strategy	
  	
  
PragmaAc	
  REST:	
  API	
  Design	
  Fu	
  
10	
  PaJerns	
  in	
  Successful	
  API	
  Programs	
  
Today:	
  API	
  Metrics	
  –	
  What	
  to	
  Measure?	
  
API	
  Technology	
  &	
  OperaAons	
  
Your	
  API	
  Sucks!	
  
Next:	
  PCI	
  Compliance	
  and	
  APIs	
  
Tired I am. REST I must.
THANKS!	
  
	
  
Send	
  ques<ons,	
  examples,	
  and	
  ideas	
  to	
  @apigee	
  




 Marsh	
  Gardiner 	
              	
      	
  Brian	
  Mulloy	
  
 marsh@apigee.com 	
               	
      	
  brian@apigee.com	
  
 @earth2marsh             	
        	
      	
  @landlessness	
  	
  

Contenu connexe

Tendances

Automating Hybrid Applications with Appium
Automating Hybrid Applications with AppiumAutomating Hybrid Applications with Appium
Automating Hybrid Applications with Appium
Sauce Labs
 
Native iphone app test automation with appium
Native iphone app test automation with appiumNative iphone app test automation with appium
Native iphone app test automation with appium
James Eisenhauer
 
Building your first Native iOs App with an API Backend
Building your first Native iOs App with an API BackendBuilding your first Native iOs App with an API Backend
Building your first Native iOs App with an API Backend
Apigee | Google Cloud
 

Tendances (20)

Spring Boot Interview Questions | Edureka
Spring Boot Interview Questions | EdurekaSpring Boot Interview Questions | Edureka
Spring Boot Interview Questions | Edureka
 
Ten Reasons Developers Hate Your API
Ten Reasons Developers Hate Your APITen Reasons Developers Hate Your API
Ten Reasons Developers Hate Your API
 
Herding Microservices – the Atlassian Way
Herding Microservices – the Atlassian WayHerding Microservices – the Atlassian Way
Herding Microservices – the Atlassian Way
 
10 things you didnt know about appium + whats new in appium 1.5
10 things you didnt know about appium + whats new in appium 1.510 things you didnt know about appium + whats new in appium 1.5
10 things you didnt know about appium + whats new in appium 1.5
 
Automating Hybrid Applications with Appium
Automating Hybrid Applications with AppiumAutomating Hybrid Applications with Appium
Automating Hybrid Applications with Appium
 
Improving Android app testing with Appium and Sauce Labs
Improving Android app testing with Appium and Sauce LabsImproving Android app testing with Appium and Sauce Labs
Improving Android app testing with Appium and Sauce Labs
 
Native iphone app test automation with appium
Native iphone app test automation with appiumNative iphone app test automation with appium
Native iphone app test automation with appium
 
Building your first Native iOs App with an API Backend
Building your first Native iOs App with an API BackendBuilding your first Native iOs App with an API Backend
Building your first Native iOs App with an API Backend
 
[Srijan Wednesday Webinar] Mastering Mobile Test Automation with Appium
[Srijan Wednesday Webinar] Mastering Mobile Test Automation with Appium[Srijan Wednesday Webinar] Mastering Mobile Test Automation with Appium
[Srijan Wednesday Webinar] Mastering Mobile Test Automation with Appium
 
Testing on Mobile Devices with Location Services
Testing on Mobile Devices with Location ServicesTesting on Mobile Devices with Location Services
Testing on Mobile Devices with Location Services
 
Your API Sucks
Your API SucksYour API Sucks
Your API Sucks
 
Mobile Automation Using Appium - vodQA Bangalore 2015
Mobile Automation Using Appium - vodQA Bangalore 2015Mobile Automation Using Appium - vodQA Bangalore 2015
Mobile Automation Using Appium - vodQA Bangalore 2015
 
On boarding Appium Open Source
On boarding Appium Open SourceOn boarding Appium Open Source
On boarding Appium Open Source
 
Infrastructure Automation How to Use Chef For DevOps Success
Infrastructure Automation How to Use Chef For DevOps SuccessInfrastructure Automation How to Use Chef For DevOps Success
Infrastructure Automation How to Use Chef For DevOps Success
 
DevOps + MongoDB Realm Serverless Functions = 🤩
DevOps + MongoDB Realm Serverless Functions = 🤩DevOps + MongoDB Realm Serverless Functions = 🤩
DevOps + MongoDB Realm Serverless Functions = 🤩
 
Wheat - Mobile functional test automation
Wheat - Mobile functional test automationWheat - Mobile functional test automation
Wheat - Mobile functional test automation
 
Live Panel: Appium Core Committers Answer Your Questions
Live Panel: Appium Core Committers Answer Your Questions		Live Panel: Appium Core Committers Answer Your Questions
Live Panel: Appium Core Committers Answer Your Questions
 
Selenium and Cucumber Selenium Conf 2011
Selenium and Cucumber Selenium Conf 2011Selenium and Cucumber Selenium Conf 2011
Selenium and Cucumber Selenium Conf 2011
 
Behind the Scenes of Vendor Security Reviews in the Enterprise
Behind the Scenes of Vendor Security Reviews in the EnterpriseBehind the Scenes of Vendor Security Reviews in the Enterprise
Behind the Scenes of Vendor Security Reviews in the Enterprise
 
Look, Ma! No servers! Serverless application development with MongoDB Stitch
Look, Ma! No servers! Serverless application development with MongoDB StitchLook, Ma! No servers! Serverless application development with MongoDB Stitch
Look, Ma! No servers! Serverless application development with MongoDB Stitch
 

En vedette

10 patterns in successful api programs 2
10 patterns in successful api programs 210 patterns in successful api programs 2
10 patterns in successful api programs 2
Apigee | Google Cloud
 
I Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
I Love APIs 2015: Create Design-driven APIs with Node.js and SwaggerI Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
I Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
Apigee | Google Cloud
 
The API Facade Pattern: Technology - Episode 3
The API Facade Pattern: Technology - Episode 3The API Facade Pattern: Technology - Episode 3
The API Facade Pattern: Technology - Episode 3
Apigee | Google Cloud
 
Implementing API Facade using WSO2 API Management Platform
Implementing API Facade using WSO2 API Management PlatformImplementing API Facade using WSO2 API Management Platform
Implementing API Facade using WSO2 API Management Platform
WSO2
 
APIs Inside Enterprise - SOA Displacement?
APIs Inside Enterprise - SOA Displacement?APIs Inside Enterprise - SOA Displacement?
APIs Inside Enterprise - SOA Displacement?
Apigee | Google Cloud
 

En vedette (20)

10 patterns in successful api programs 2
10 patterns in successful api programs 210 patterns in successful api programs 2
10 patterns in successful api programs 2
 
Mapping out your API Strategy - 4.20.11 Webinar slides
Mapping out your API Strategy - 4.20.11 Webinar slidesMapping out your API Strategy - 4.20.11 Webinar slides
Mapping out your API Strategy - 4.20.11 Webinar slides
 
Pragmatic RESTful API Design: Apigee Webinar
Pragmatic RESTful API Design: Apigee WebinarPragmatic RESTful API Design: Apigee Webinar
Pragmatic RESTful API Design: Apigee Webinar
 
API Product Management - Driving Success through the Value Chain
API Product Management - Driving Success through the Value ChainAPI Product Management - Driving Success through the Value Chain
API Product Management - Driving Success through the Value Chain
 
Is your API Naked? API Technology and Ops Considerations: Webinar slides
Is your API Naked? API Technology and Ops Considerations: Webinar slidesIs your API Naked? API Technology and Ops Considerations: Webinar slides
Is your API Naked? API Technology and Ops Considerations: Webinar slides
 
Microservices Done Right: Key Ingredients for Microservices Success
Microservices Done Right: Key Ingredients for Microservices SuccessMicroservices Done Right: Key Ingredients for Microservices Success
Microservices Done Right: Key Ingredients for Microservices Success
 
Webcast: Apigee Edge Product Demo
Webcast: Apigee Edge Product DemoWebcast: Apigee Edge Product Demo
Webcast: Apigee Edge Product Demo
 
Punctuated Equilibrium, Celestial Navigation, and API Strategy
Punctuated Equilibrium, Celestial Navigation,and API StrategyPunctuated Equilibrium, Celestial Navigation,and API Strategy
Punctuated Equilibrium, Celestial Navigation, and API Strategy
 
Why APIs? Second Edition - Webcast Slides
Why APIs? Second Edition - Webcast SlidesWhy APIs? Second Edition - Webcast Slides
Why APIs? Second Edition - Webcast Slides
 
I Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
I Love APIs 2015: Create Design-driven APIs with Node.js and SwaggerI Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
I Love APIs 2015: Create Design-driven APIs with Node.js and Swagger
 
Developers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API AdoptionDevelopers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API Adoption
 
Does your API need to be PCI Compliant?
Does your API need to be PCI Compliant?Does your API need to be PCI Compliant?
Does your API need to be PCI Compliant?
 
The API Facade Pattern: Technology - Episode 3
The API Facade Pattern: Technology - Episode 3The API Facade Pattern: Technology - Episode 3
The API Facade Pattern: Technology - Episode 3
 
Real-time hypermedia APIs: Exploring the fundamentals of how we build network...
Real-time hypermedia APIs: Exploring the fundamentals of how we build network...Real-time hypermedia APIs: Exploring the fundamentals of how we build network...
Real-time hypermedia APIs: Exploring the fundamentals of how we build network...
 
Implementing API Facade using WSO2 API Management Platform
Implementing API Facade using WSO2 API Management PlatformImplementing API Facade using WSO2 API Management Platform
Implementing API Facade using WSO2 API Management Platform
 
API Copyrights: New Considerations for Building or Using APIs
API Copyrights: New Considerations for Building or Using APIsAPI Copyrights: New Considerations for Building or Using APIs
API Copyrights: New Considerations for Building or Using APIs
 
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)
 
O'Reilly author webinar "APIs: A Strategy guide": Transforming Your Business...
O'Reilly author webinar "APIs: A Strategy guide":  Transforming Your Business...O'Reilly author webinar "APIs: A Strategy guide":  Transforming Your Business...
O'Reilly author webinar "APIs: A Strategy guide": Transforming Your Business...
 
Edge API BaaS Deep-Dive: Streamline app development
Edge API BaaS Deep-Dive: Streamline app developmentEdge API BaaS Deep-Dive: Streamline app development
Edge API BaaS Deep-Dive: Streamline app development
 
APIs Inside Enterprise - SOA Displacement?
APIs Inside Enterprise - SOA Displacement?APIs Inside Enterprise - SOA Displacement?
APIs Inside Enterprise - SOA Displacement?
 

Similaire à Your API Sucks! Why developers hang up and how to stop that.

API-Consumption compressed (1)
API-Consumption compressed (1)API-Consumption compressed (1)
API-Consumption compressed (1)
Rahul Ghai
 

Similaire à Your API Sucks! Why developers hang up and how to stop that. (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
 
Building a REST API for Longevity
Building a REST API for LongevityBuilding a REST API for Longevity
Building a REST API for Longevity
 
API-Consumption compressed (1)
API-Consumption compressed (1)API-Consumption compressed (1)
API-Consumption compressed (1)
 
Dev Learn Handout - Session 604
Dev Learn Handout - Session 604Dev Learn Handout - Session 604
Dev Learn Handout - Session 604
 
Introduction to GraphQL (or How I Learned to Stop Worrying about REST APIs)
Introduction to GraphQL (or How I Learned to Stop Worrying about REST APIs)Introduction to GraphQL (or How I Learned to Stop Worrying about REST APIs)
Introduction to GraphQL (or How I Learned to Stop Worrying about REST APIs)
 
Managing micro services for your company
Managing micro services for your companyManaging micro services for your company
Managing micro services for your company
 
Accidental API developer - the 12 month pregnancy to create new API
Accidental API developer - the 12 month pregnancy to create new APIAccidental API developer - the 12 month pregnancy to create new API
Accidental API developer - the 12 month pregnancy to create new API
 
APIS for Startups - Running your Business Inside Out
APIS for Startups - Running your Business Inside OutAPIS for Startups - Running your Business Inside Out
APIS for Startups - Running your Business Inside Out
 
Chris Mathias Presents Advanced API Design Considerations at LA CTO Forum
Chris Mathias Presents Advanced API Design Considerations at LA CTO ForumChris Mathias Presents Advanced API Design Considerations at LA CTO Forum
Chris Mathias Presents Advanced API Design Considerations at LA CTO Forum
 
Clickslide Datadipity Beta V1
Clickslide Datadipity Beta V1Clickslide Datadipity Beta V1
Clickslide Datadipity Beta V1
 
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
 
OpenACT - Meet1 - Intro to APIs
OpenACT - Meet1 - Intro to APIsOpenACT - Meet1 - Intro to APIs
OpenACT - Meet1 - Intro to APIs
 
Building Your API for Longevity
Building Your API for LongevityBuilding Your API for Longevity
Building Your API for Longevity
 
Always Mind Your [Developer] Surroundings - API City 2018
Always Mind Your [Developer] Surroundings - API City 2018Always Mind Your [Developer] Surroundings - API City 2018
Always Mind Your [Developer] Surroundings - API City 2018
 
FOSDEM 2024 - Deploy Fast, Without Breaking Things: Level Up APIOps With Open...
FOSDEM 2024 - Deploy Fast, Without Breaking Things: Level Up APIOps With Open...FOSDEM 2024 - Deploy Fast, Without Breaking Things: Level Up APIOps With Open...
FOSDEM 2024 - Deploy Fast, Without Breaking Things: Level Up APIOps With Open...
 
Web API Design
Web API DesignWeb API Design
Web API Design
 
Web API Design: Crafting Interfaces that Developers Love
Web API Design:  Crafting Interfaces that Developers LoveWeb API Design:  Crafting Interfaces that Developers Love
Web API Design: Crafting Interfaces that Developers Love
 
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 Helsinki & North 2022_How to Win Friends and Influence People wi...
apidays LIVE Helsinki & North 2022_How to Win Friends and Influence People wi...apidays LIVE Helsinki & North 2022_How to Win Friends and Influence People wi...
apidays LIVE Helsinki & North 2022_How to Win Friends and Influence People wi...
 
Enterprise E-Commerce Webinar #3: Bringing Your API to Market
Enterprise E-Commerce Webinar #3: Bringing Your API to MarketEnterprise E-Commerce Webinar #3: Bringing Your API to Market
Enterprise E-Commerce Webinar #3: Bringing Your API to Market
 

Plus de Apigee | Google Cloud

Plus de Apigee | Google Cloud (20)

How Secure Are Your APIs?
How Secure Are Your APIs?How Secure Are Your APIs?
How Secure Are Your APIs?
 
Magazine Luiza at a glance (1)
Magazine Luiza at a glance (1)Magazine Luiza at a glance (1)
Magazine Luiza at a glance (1)
 
Monetization: Unlock More Value from Your APIs
Monetization: Unlock More Value from Your APIs Monetization: Unlock More Value from Your APIs
Monetization: Unlock More Value from Your APIs
 
Apigee Demo: API Platform Overview
Apigee Demo: API Platform OverviewApigee Demo: API Platform Overview
Apigee Demo: API Platform Overview
 
Ticketmaster at a glance
Ticketmaster at a glanceTicketmaster at a glance
Ticketmaster at a glance
 
AccuWeather: Recasting API Experiences in a Developer-First World
AccuWeather: Recasting API Experiences in a Developer-First WorldAccuWeather: Recasting API Experiences in a Developer-First World
AccuWeather: Recasting API Experiences in a Developer-First World
 
Which Application Modernization Pattern Is Right For You?
Which Application Modernization Pattern Is Right For You?Which Application Modernization Pattern Is Right For You?
Which Application Modernization Pattern Is Right For You?
 
Apigee Product Roadmap Part 2
Apigee Product Roadmap Part 2Apigee Product Roadmap Part 2
Apigee Product Roadmap Part 2
 
The Four Transformative Forces of the API Management Market
The Four Transformative Forces of the API Management MarketThe Four Transformative Forces of the API Management Market
The Four Transformative Forces of the API Management Market
 
Walgreens at a glance
Walgreens at a glanceWalgreens at a glance
Walgreens at a glance
 
Apigee Edge: Intro to Microgateway
Apigee Edge: Intro to MicrogatewayApigee Edge: Intro to Microgateway
Apigee Edge: Intro to Microgateway
 
Managing the Complexity of Microservices Deployments
Managing the Complexity of Microservices DeploymentsManaging the Complexity of Microservices Deployments
Managing the Complexity of Microservices Deployments
 
Pitney Bowes at a glance
Pitney Bowes at a glancePitney Bowes at a glance
Pitney Bowes at a glance
 
Adapt or Die: Opening Keynote with Chet Kapoor
Adapt or Die: Opening Keynote with Chet KapoorAdapt or Die: Opening Keynote with Chet Kapoor
Adapt or Die: Opening Keynote with Chet Kapoor
 
Adapt or Die: Keynote with Greg Brail
Adapt or Die: Keynote with Greg BrailAdapt or Die: Keynote with Greg Brail
Adapt or Die: Keynote with Greg Brail
 
Adapt or Die: Keynote with Anant Jhingran
Adapt or Die: Keynote with Anant JhingranAdapt or Die: Keynote with Anant Jhingran
Adapt or Die: Keynote with Anant Jhingran
 
London Adapt or Die: Opening Keynot
London Adapt or Die: Opening KeynotLondon Adapt or Die: Opening Keynot
London Adapt or Die: Opening Keynot
 
London Adapt or Die: Lunch keynote
London Adapt or Die: Lunch keynoteLondon Adapt or Die: Lunch keynote
London Adapt or Die: Lunch keynote
 
London Adapt or Die: Closing Keynote — Adapt Now!
London Adapt or Die: Closing Keynote — Adapt Now!London Adapt or Die: Closing Keynote — Adapt Now!
London Adapt or Die: Closing Keynote — Adapt Now!
 
London adapt or-die opening keynote chet kapoor
London adapt or-die opening keynote chet kapoorLondon adapt or-die opening keynote chet kapoor
London adapt or-die opening keynote chet kapoor
 

Dernier

Why Teams call analytics are critical to your entire business
Why Teams call analytics are critical to your entire businessWhy Teams call analytics are critical to your entire business
Why Teams call analytics are critical to your entire business
panagenda
 

Dernier (20)

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
 
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...
 
Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024
 
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
 
MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024MINDCTI Revenue Release Quarter One 2024
MINDCTI Revenue Release Quarter One 2024
 
Understanding Discord NSFW Servers A Guide for Responsible Users.pdf
Understanding Discord NSFW Servers A Guide for Responsible Users.pdfUnderstanding Discord NSFW Servers A Guide for Responsible Users.pdf
Understanding Discord NSFW Servers A Guide for Responsible Users.pdf
 
2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...
 
Why Teams call analytics are critical to your entire business
Why Teams call analytics are critical to your entire businessWhy Teams call analytics are critical to your entire business
Why Teams call analytics are critical to your entire business
 
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
 
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
 
Strategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherStrategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a Fresher
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
 
Data Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt RobisonData Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt Robison
 
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
 
AWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of TerraformAWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of Terraform
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)
 
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
 
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
 
Top 10 Most Downloaded Games on Play Store in 2024
Top 10 Most Downloaded Games on Play Store in 2024Top 10 Most Downloaded Games on Play Store in 2024
Top 10 Most Downloaded Games on Play Store in 2024
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 

Your API Sucks! Why developers hang up and how to stop that.

  • 1. Your  API  Sucks   Why  developers  hang  up  and  how  to  stop  that.   Rapid  API  Workshop   Marsh  Gardiner      Brian  Mulloy   @earth2marsh      @landlessness    
  • 2. @earth2marsh @landlessness
  • 3. Rapid API Workshop Webinar Series Mapping  out  your  API  Strategy     PragmaAc  REST:  API  Design  Fu   10  PaJerns  of  Successful  API  Programs   API  Metrics  –  What  to  Measure?   API  Technology  &  OperaAons   Today:  Your  API  Sucks!   PCI  Compliance  and  APIs    
  • 4. THIS TALK IN A NUTSHELL •   User  experience  wins   •   API  users  =  developers   •   Developer  experiences  (generally)  suck   •   But  they  don’t  have  to…  
  • 6.
  • 7. Four simple rules 1. Give developers every reason to build 2. Make them successful faster 3. Don't violate their trust 4. Listen
  • 8. Hangup Reason #1 Why would I use your API?
  • 9. Why  did  you   build  an  API?  
  • 10.
  • 11.
  • 12. Four simple rules 1. Give developers every reason to build 2. Make them successful faster 3. Don't violate their trust 4. Listen
  • 13.
  • 14. Simple  things  should  be  simple.   Complex  things  should  be  possible.              —  Alan  Kay  
  • 15.
  • 16. Krug says: 1. People don’t read pages. They scan them. 2. People don’t make optimal choices. They satisfice. 3. People don’t figure out how things work. They muddle through.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21. Hangup Reason #2 You’re making this too hard.
  • 22.
  • 23. TTFR Time   To   First   Request  
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29. Four simple rules 1. Give developers every reason to build 2. Make them successful faster 3. Don't violate their trust 4. Listen
  • 30.
  • 31. Hangup Reason #3 Are you going to support me?
  • 32.
  • 33.
  • 34.
  • 35.
  • 36. Four simple rules 1. Give developers every reason to build 2. Make them successful faster 3. Don't violate their trust 4. Listen
  • 37.
  • 38. Your  API  is  a  product.   Treat  it  that  way.   Your  developers  are  your  customers.  
  • 39.
  • 40.
  • 41.
  • 42.
  • 43. Why  is  this  so  hard?  
  • 44. Why  does  Freemium  work?  
  • 45.
  • 47. SOAP   POST /InStock HTTP/1.1 Host: www.example.org Content-Type: application/soap+xml; charset=utf-8 Content-Length: 299 <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"> <soap:Header> </soap:Header> <soap:Body> <m:GetStockPrice xmlns:m="http://www.example.org/stock"> <m:StockName>IBM</m:StockName> </m:GetStockPrice> </soap:Body> </soap:Envelope>
  • 48. Why  REST  is  winning:   http://api.twitter.com/1/statuses/public_timeline.json
  • 49.
  • 50. Your  engineers  may  be  great  at  wriAng  the   code  behind  your  API.     Are  they  great  at  designing  for  API  adop<on?    
  • 52.
  • 53.
  • 54.
  • 55. Opacity  is  inscrutable.  (Also,  unforgivable.)   Give  devs  the  informa<on  they  need  to  succeed.  
  • 56.
  • 57.
  • 59.
  • 60.
  • 61.
  • 62.
  • 63.
  • 64. Put  yourself  in  their  shoes.  
  • 65. Four simple rules 1. Give developers every reason to build 2. Make them successful faster 3. Don't violate their trust 4. Listen
  • 66. Rapid API Workshop Webinar Series Mapping  out  your  API  Strategy     PragmaAc  REST:  API  Design  Fu   10  PaJerns  in  Successful  API  Programs   Today:  API  Metrics  –  What  to  Measure?   API  Technology  &  OperaAons   Your  API  Sucks!   Next:  PCI  Compliance  and  APIs  
  • 67.
  • 68. Tired I am. REST I must.
  • 69. THANKS!     Send  ques<ons,  examples,  and  ideas  to  @apigee   Marsh  Gardiner      Brian  Mulloy   marsh@apigee.com      brian@apigee.com   @earth2marsh      @landlessness