apidays LIVE Hong Kong 2021 - API Ecosystem & Data Interchange August 25 & 26, 2021 Automating the API Product Lifecycle Jeremy Glassenberg, Product Lead, APIs at 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

3. Life before Swagger/OpenAPI

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

16. Visually planning OpenAPI

17. App Marketplace Frameworks

18. More Monitoring Use Cases
API information to
Sales and Customer
Support?

19. Future Opportunities
Full Server-Stubs

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