Diese Präsentation wurde erfolgreich gemeldet.
Wir verwenden Ihre LinkedIn Profilangaben und Informationen zu Ihren Aktivitäten, um Anzeigen zu personalisieren und Ihnen relevantere Inhalte anzuzeigen. Sie können Ihre Anzeigeneinstellungen jederzeit ändern.
1
Definition Driven API Development
Streamlining your API Development with OAS
Martin McDonagh
Lead Solutions Architect –
...
2
Understanding Definition-Driven
API Development
3
API First Approach
Client A Client B Client C
API API API
Mock Mock Mock
Implementation Implementation Implementation
Fr...
4
Definition Driven API development advocates for designing the API’s contract first
before any other lifecycle operation
...
5
• A definition is a framework for describing APIs
• Machine and human readable
• Language agnostic
A Common Vocabulary
T...
6
Reduced interdependencies, allow teams to work at their own pace
Fast development and delivery
Easier expansion to diffe...
7
OAS opens a world of possibilities
Mocking
Design
Clients
Deployment/Runtime Documentation
Virtualization
Testing
Implem...
8
Definitions Touch Every Phase of the Lifecycle
Design
Document
Virtualize
Code
Test
9
Documentation from Definition
Auto generation from contract
Hosted anywhere
Fully interactive
10
OAS and Service
Virtualization
11
Virtualization accurately mimics/simulates behaviour of components that are unavailable or
difficult to access during s...
12
Virtualization from the Definition
Virtualization
• Developers
• Testers
• Other Stakeholders
Consumer
Development
13
OAS and Code Generation
14
The OAS definition allows you to generate server stubs and client SDKs directly from the definition
Code-Generation fro...
15
OAS and Testing
16
Testing from the Definition
The OAS definition allows you to generate test cases directly from the contract
Tester
Test...
17
• OpenAPI Specification is machine and human readable
• OAS allows for parallel development
• OAS can be driven across ...
Proprietary & Confidential
1818
Thank You
martin.mcdonagh@smartbear.com
Nächste SlideShare
Wird geladen in …5
×

apidays LIVE Australia - Definition-Driven API Development: Streamlining your API Development with OAS by Martin McDonagh

1.049 Aufrufe

Veröffentlicht am

apidays LIVE Australia - Building Business Ecosystems
Definition-Driven API Development: Streamlining your API Development with OAS
Martin McDonagh, Lead Solutions Architect at SmartBear

Veröffentlicht in: Technologie
  • Als Erste(r) kommentieren

  • Gehören Sie zu den Ersten, denen das gefällt!

apidays LIVE Australia - Definition-Driven API Development: Streamlining your API Development with OAS by Martin McDonagh

  1. 1. 1 Definition Driven API Development Streamlining your API Development with OAS Martin McDonagh Lead Solutions Architect – APAC @ SmartBear
  2. 2. 2 Understanding Definition-Driven API Development
  3. 3. 3 API First Approach Client A Client B Client C API API API Mock Mock Mock Implementation Implementation Implementation Frontend Developers Backend Developers The API First approach involves having your APIs as the first and primary element of your product and service strategy, Database
  4. 4. 4 Definition Driven API development advocates for designing the API’s contract first before any other lifecycle operation The Definition Driven Answer Drives Implementation Maintenance Consumption
  5. 5. 5 • A definition is a framework for describing APIs • Machine and human readable • Language agnostic A Common Vocabulary The Open API Specification (OAS) is the world’s standard for defining RESTful APIs
  6. 6. 6 Reduced interdependencies, allow teams to work at their own pace Fast development and delivery Easier expansion to different interfaces, clients and views Developer friendly services to build ecosystems and platforms Advantages of Definition Driven Development Faster Development New Revenue Channels and Growth
  7. 7. 7 OAS opens a world of possibilities Mocking Design Clients Deployment/Runtime Documentation Virtualization Testing Implementation Prototyping Object reuse, Callbacks etc. Generated client libraries Security, Usage policies, Monitoring, Caching, etc. Developer portals, code samples, User guides, etc. Functional/Runtime simulations Functional, Security, Load, etc. Generated server code/artifacts
  8. 8. 8 Definitions Touch Every Phase of the Lifecycle Design Document Virtualize Code Test
  9. 9. 9 Documentation from Definition Auto generation from contract Hosted anywhere Fully interactive
  10. 10. 10 OAS and Service Virtualization
  11. 11. 11 Virtualization accurately mimics/simulates behaviour of components that are unavailable or difficult to access during software development and beyond. Examples of components that can be virtualized: Service Virtualization Devices Databases API Network
  12. 12. 12 Virtualization from the Definition Virtualization • Developers • Testers • Other Stakeholders Consumer Development
  13. 13. 13 OAS and Code Generation
  14. 14. 14 The OAS definition allows you to generate server stubs and client SDKs directly from the definition Code-Generation from the Definition Developer Consumer Codegeneration SDK
  15. 15. 15 OAS and Testing
  16. 16. 16 Testing from the Definition The OAS definition allows you to generate test cases directly from the contract Tester TestAPI Testing tool Refactored Refactored Test cases
  17. 17. 17 • OpenAPI Specification is machine and human readable • OAS allows for parallel development • OAS can be driven across the full API Lifecycle • Virtualization allows to build an advanced mock from the OAS definition that is dynamic • It is also possible to build a test in minutes directly from the OAS definition using Open Source or Professional API testing tools Summary
  18. 18. Proprietary & Confidential 1818 Thank You martin.mcdonagh@smartbear.com

×