Looking at the full API Product Lifecycle, from defining an API and implementing the API, to launching with a solid developer site and experience, let’s see the newest tools - and potentially upcoming opportunities - to automate the creation of a solid developer experience.
Creating a successful API requires a proper process from concept and design, through development, and into ongoing maintenance and responsive developer support. As developer expectations for better-quality APIs increase, tools have made it easier to implement this well. Thanks to standards like OpenAPIs, it’s easier to create a quality API, developer site, and overall experience. Many of us create API documentation or code libraries automatically from an OpenAPI spec, but there’s a lot more coming along to make our lives easier, and to make our APIs look better. In reviewing the full API Product Lifecycle to design an API people will use, let’s see the newest tools - and potentially upcoming opportunities - to better automate the creation of a compelling developer program.
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
DocumentationDeveloper Portal/App MarketplaceBuild
Monitor
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