Love your API with Swagger (Gluecon lightning talk)

•Transferir como PPTX, PDF•

2 gostaram•1,583 visualizações

Tony Tam

Software Tecnologia

Who Loves your API?
• Developers want to write software
• Might want to use your API
• Have a different workflow than you
• Almost always has other options

Steps to Adoption
1. Found your API
2. Try it out
3. Try to integrate with you
4. Love or Abandonment
Your API won’t be used if not
understood

Humanize your API
Swagger makes your API
• Understandable
• Testable
• Discoverable
• Ready to Integrate

Humans and Machines
• Simple description structure in JSON
• Built as you like
– Code
– JSON
– YAML
– GUI
• No “pointer chasing”
Not just
Hello
World

Try it out
“Even your boss can try your API”

Build it how you like
• It’s just JSON
– Host on API server, CDN, GitHub
• Discoverable by your process

Your Users can Use your API
• Generate Clean, Functional SDKs
• Your consumers want to use your service
– How they want
– Not write your software

Swagger has a Community
Swaggers roots are based on Results
JAX-RS (java) Scalatra (scala) Spring MVC (java)
Spray (scala) Composer (PHP) django (python)
Flask (python) Go Maven (JAX-RS)
ServiceStack (.net) Doctrine (PHP) Express (JS)
Restler (PHP) Hapi (JS) Clojure

Swagger is FOSS
• Apache 2 License
https://github.com/wordnik/swagger-spec
https://github.com/wordnik/swagger-core
https://github.com/wordnik/swagger-codegen
https://github.com/wordnik/swagger-ui
https://github.com/wordnik/swagger-node-express
https://github.com/scalatra/scalatra

Where to find out more
Google Groups
• https://groups.google.com/forum/#!forum/s
wagger-swaggersocket
IRC
• irc.freenode.net
Email
• apiteam@wordnik.com
Gluecon
Day 2

Mais conteúdo relacionado

Mais procurados

Swagger for-your-apiTony Tam

SwaggerNexThoughts Technologies

Swagger in the API LifecycleOle Lensmar

Scala & Swagger at WordnikTony Tam

Design Driven API DevelopmentSokichi Fujita

Do's and Don'ts of APIsJason Harmon

Swagger for startupsTony Tam

Api Design Anti-PatternsJason Harmon

API Design first with SwaggerTony Tam

Designing APIs with OpenAPI SpecAdam Paxton

API Developer Experience: Why it Matters, and How Documenting Your API with S...SmartBear

Implement Web API with SwaggerJiang Wu

Mocking APIs Collaboratively with PostmanNordic APIs

Challenges of moving a java team to scalaJoão Cavalheiro

Getting Predictable - Pragmatic Approach for Mobile Development - Devday.lk ...Anjana Somathilake

Using TypeScript with AngularJamal Sinclair O'Garro

Hands on BDD with cucumber - Agile Goa Sept 2013Sonik Chopra

A Tasty deep-dive into Open API Specification LinksTony Tam

How to build a Whatsapp clone in 2 hoursJane Chung

A guide to hiring a great developer to build your first app (redacted version)Oursky

Mais procurados (20)

Swagger for-your-api

Swagger

Swagger in the API Lifecycle

Scala & Swagger at Wordnik

Design Driven API Development

Do's and Don'ts of APIs

Swagger for startups

Api Design Anti-Patterns

API Design first with Swagger

Designing APIs with OpenAPI Spec

API Developer Experience: Why it Matters, and How Documenting Your API with S...

Implement Web API with Swagger

Mocking APIs Collaboratively with Postman

Challenges of moving a java team to scala

Getting Predictable - Pragmatic Approach for Mobile Development - Devday.lk ...

Using TypeScript with Angular

Hands on BDD with cucumber - Agile Goa Sept 2013

A Tasty deep-dive into Open API Specification Links

How to build a Whatsapp clone in 2 hours

A guide to hiring a great developer to build your first app (redacted version)

Semelhante a Love your API with Swagger (Gluecon lightning talk)

Swagger - Making REST APIs friendlierMiroslav Resetar

API Description LanguagesAkana

Swagger: Restful documentation that won't put you to sleepTobias Coetzee

API Description Languages: Which Is The Right One For Me? ProgrammableWeb

Beyond the basic Swagger UI: Adyen API ExplorerAleksei Akimov

Developing Brilliant and Powerful APIs in Ruby & PythonSmartBear

Always up to date, testable and maintainable documentation with OpenAPIGOG.com dev team

apidays LIVE Australia 2020 - Have your cake and eat it too: GraphQL? REST? W...apidays

API Description Languages: Which is the Right One for Me?Akana

Building a REST API for LongevityMuleSoft

The API Lifecycle Series: Evolving API Development and Testing from Open Sour...SmartBear

Maine WordPress Meetup JSON REST API, 3/16/2016Andre Gagnon

Practices and Tools for Building Better APIsPeter Hendriks

DevQA: make your testers happier with Groovy, Spock and Geb (Greach 2014)Alvaro Sanchez-Mariscal

API Conference 2021José Haro Peralta

API Design - developing for developersJoy George

Tools and techniques for APIsJason Harmon

Expose Yourself! How to Leverage Plugin Extensibility to Delight your Users, ...Atlassian

Semelhante a Love your API with Swagger (Gluecon lightning talk) (20)

Swagger - Making REST APIs friendlier

API Description Languages

Swagger: Restful documentation that won't put you to sleep

API Description Languages: Which Is The Right One For Me?

Beyond the basic Swagger UI: Adyen API Explorer

Developing Brilliant and Powerful APIs in Ruby & Python

Always up to date, testable and maintainable documentation with OpenAPI

apidays LIVE Australia 2020 - Have your cake and eat it too: GraphQL? REST? W...

API Description Languages: Which is the Right One for Me?

Building a REST API for Longevity

The API Lifecycle Series: Evolving API Development and Testing from Open Sour...

Maine WordPress Meetup JSON REST API, 3/16/2016

Practices and Tools for Building Better APIs

DevQA: make your testers happier with Groovy, Spock and Geb (Greach 2014)

API Conference 2021

API Design - developing for developers

Tools and techniques for APIs

Expose Yourself! How to Leverage Plugin Extensibility to Delight your Users, ...

Mais de Tony Tam

Writer APIs in Java faster with Swagger InflectorTony Tam

Fastest to Mobile with Scalatra + SwaggerTony Tam

Data Modeling for NoSQLTony Tam

System insight without InterferenceTony Tam

Keeping MongoDB Data SafeTony Tam

Inside Wordnik's ArchitectureTony Tam

Scaling with swaggerTony Tam

Running MongoDB in the CloudTony Tam

Why Wordnik went non-relationalTony Tam

Building a Directed Graph with MongoDBTony Tam

Managing a MongoDB DeploymentTony Tam

Keeping the Lights On with MongoDBTony Tam

Migrating from MySQL to MongoDB at WordnikTony Tam

Mais de Tony Tam (13)

Writer APIs in Java faster with Swagger Inflector

Fastest to Mobile with Scalatra + Swagger

Data Modeling for NoSQL

System insight without Interference

Keeping MongoDB Data Safe

Inside Wordnik's Architecture

Scaling with swagger

Running MongoDB in the Cloud

Why Wordnik went non-relational

Building a Directed Graph with MongoDB

Managing a MongoDB Deployment

Keeping the Lights On with MongoDB

Migrating from MySQL to MongoDB at Wordnik

Último

Reassessing the Bedrock of Clinical Function Models: An Examination of Large ...harshavardhanraghave

Unlocking the Future of AI Agents with Large Language Modelsaagamshah0812

%in Lydenburg+277-882-255-28 abortion pills for sale in Lydenburgmasabamasaba

Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...SelfMade bd

Direct Style Effect Systems -The Print[A] Example- A Comprehension AidPhilip Schwarz

%in kempton park+277-882-255-28 abortion pills for sale in kempton park masabamasaba

OpenChain - The Ramifications of ISO/IEC 5230 and ISO/IEC 18974 for Legal Pro...Shane Coughlan

%in Midrand+277-882-255-28 abortion pills for sale in midrandmasabamasaba

%+27788225528 love spells in new york Psychic Readings, Attraction spells,Bri...masabamasaba

call girls in Vaishali (Ghaziabad) 🔝 >༒8448380779 🔝 genuine Escort Service 🔝✔️✔️Delhi Call girls

Microsoft AI Transformation Partner Playbook.pdfWilly Marroquin (WillyDevNET)

W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...panagenda

CHEAP Call Girls in Pushp Vihar (-DELHI )🔝 9953056974🔝(=)/CALL GIRLS SERVICE9953056974 Low Rate Call Girls In Saket, Delhi NCR

Introducing Microsoft’s new Enterprise Work Management (EWM) SolutionOnePlan Solutions

%in Stilfontein+277-882-255-28 abortion pills for sale in Stilfonteinmasabamasaba

Define the academic and professional writing..pdfPearlKirahMaeRagusta1

8257 interfacing 2 in microprocessor for btech studentsHimanshiGarg82

%in Harare+277-882-255-28 abortion pills for sale in Hararemasabamasaba

VTU technical seminar 8Th Sem on Scikit-learnAmarnathKambale

%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...masabamasaba

Love your API with Swagger (Gluecon lightning talk)

1. Love your API with Swagger @fehguy

2. Who Loves your API? • Developers want to write software • Might want to use your API • Have a different workflow than you • Almost always has other options

3. Steps to Adoption 1. Found your API 2. Try it out 3. Try to integrate with you 4. Love or Abandonment Your API won’t be used if not understood

4. Humanize your API Swagger makes your API • Understandable • Testable • Discoverable • Ready to Integrate

5. Humans and Machines • Simple description structure in JSON • Built as you like – Code – JSON – YAML – GUI • No “pointer chasing” Not just Hello World

6. Try it out “Even your boss can try your API”

7. Build it how you like • It’s just JSON – Host on API server, CDN, GitHub • Discoverable by your process

8. Your Users can Use your API • Generate Clean, Functional SDKs • Your consumers want to use your service – How they want – Not write your software

9. Swagger has a Community Swaggers roots are based on Results JAX-RS (java) Scalatra (scala) Spring MVC (java) Spray (scala) Composer (PHP) django (python) Flask (python) Go Maven (JAX-RS) ServiceStack (.net) Doctrine (PHP) Express (JS) Restler (PHP) Hapi (JS) Clojure

10. Swagger is FOSS • Apache 2 License https://github.com/wordnik/swagger-spec https://github.com/wordnik/swagger-core https://github.com/wordnik/swagger-codegen https://github.com/wordnik/swagger-ui https://github.com/wordnik/swagger-node-express https://github.com/scalatra/scalatra

11. Where to find out more Google Groups • https://groups.google.com/forum/#!forum/s wagger-swaggersocket IRC • irc.freenode.net Email • apiteam@wordnik.com Gluecon Day 2

Notas do Editor

Your browser runs javascript. The J in JSON Don’t use github? Want to filter by credentials?

Love your API with Swagger (Gluecon lightning talk)

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Semelhante a Love your API with Swagger (Gluecon lightning talk)

Semelhante a Love your API with Swagger (Gluecon lightning talk) (20)

Mais de Tony Tam

Mais de Tony Tam (13)

Último

Último (20)

Love your API with Swagger (Gluecon lightning talk)

Notas do Editor