apidays LIVE Hong Kong 2021 - Automating the API Product Lifecycle by Jeremy Glassenberg, Docusign
0 likes382 views
The document discusses the automation of the API product lifecycle, highlighting tools and strategies for managing developer relationships, documentation, and API monitoring. It outlines the evolution from WADL to OpenAPI and emphasizes the importance of using modern tools for API design, implementation, and documentation. The text also explores future opportunities in developer relationship management as a business focus.
apidays LIVE Hong Kong 2021 - Automating the API Product Lifecycle by Jeremy Glassenberg, Docusign
- 1. Automating the API Product Lifecycle Jeremy Glassenberg
- 2. About Me Founder of the Box developer platform Early writer for ProgrammableWeb Managed these platforms Mentor, advisor, consultant for other developer platforms & accelerators
- 4. Life before Swagger/OpenAPI Actually, it looked more like this <sample> <id>238901423424</id> <value>15</value> <license>IH8XML</license> </sample> WADL
- 5. And then came JSON… and Swagger And REST became easy And documentation became easy
- 6. But what was the value? More Automation Tools Came Along Generate Swagger from Comments Generate Swagger and APIs from database schemas https://github.com/swaggo/swag https://github.com/dbohdan/automatic-api
- 7. If You Build It, They Will Come…? It doesn’t work in Product, and won’t work for APIs
- 8. API Product LifeCycle Manage the Developer Community - Developer Relationship Management - API Monitoring Maintain & Iterate Launch the API, Developer Experience - Documentation (Redoc, SwaggerHub) - SDKs (SwaggerHub, APImatic) - Dev Portal (Kong, AWS Dev Portal) Launch Build the API - AWS API Gateway, Kong, Apigee Implement Create Schema Definition for the API - IDEs (Postman, Insomnia) - OpenAPI Schema Design Establish High Level Architecture - Schema.org - GraphQL Vs REST Research Determine Value Points and Use Cases - Value Proposition Canvas - Business Model Canvas Identify
- 9. Tools for the Lifecycle Design Maintain Launch Implement Monitor
- 10. Designing the API IDEs SwaggerHub, Stoplight, Insomnia
- 11. Building the API Code Creation, Code Minimization API Gateway Server Code Stubs
- 12. Developer Experience Docs, Portals, Oh My! API Docs Kong Portal
- 13. Developer Experience Library Generators Mock Servers (Prism) https://github.com/OpenAPITools/openapi-generator https://stoplight.io/open-source/prism/ And SDKs! And Mock Servers
- 14. Sample Product Stack 1 API Designs Tools: SwaggerHub, Stoplight, Postman Input: User Stories Output: OpenAPI 3 Developer Portal/Marketplace Tools: Kong Dev Portal, OpenChannel.io Input: OpenAPI Output: Developer Management site, Sandbox 5 API Code Tools: Kong, AWS Gateway, WSO2 Input: OpenAPI Output: Reverse Proxy and actual APIs API Documentation Tools: Redoc, Prism, APIMatic Input: OpenAPI Output: HTML docs, SDKs, Mock Server 4 Monitoring Tools: Moesif, Kong Vitals Input: OpenAPI Output: HTML docs 2
- 15. Thinking outside the Box: Schema Decorators https://jglassenberg.github.io/REST-API-Endpoint-Generator/demo POST GET GET {id} PUT PATCH DELETE
- 18. More Monitoring Use Cases API information to Sales and Customer Support?
- 20. Developer Relationship Management (DRM) as a business https://redmonk.com/jgovernor/2017/07/03/de veloper-relationship-management-as-a-thing/ https://www.moesif.com/solutions/developer-rel ations
- 21. To a Better Future! Plugins