“#APIs can boost business because it prepares you for digital ecosystems” - @KoenAdolfs. If you would like to know… https://t.co/Y9l5IGI37w
This talk was presented at API The Docs Virtual 2020 event series on 7 October. We are honored to share the video recording, slide deck, and talk summary below. Enjoy!
Visit the API The Docs 2020 recaps overview to explore all presentations this year.
Product & Platform (API) Leader at Deserve
We can go beyond generating API documentation of OpenAPI schemas, but to successfully utilize innovative solutions, you have to follow the path of the API Product lifecycle.
In 2008, REST APIs were rough and based on XML. They seemed simple to implement, but they weren't implemented well, partially because we didn’t have standards well adapted.
Having a schema in Web Application Description Language (WADL) you were able to auto-generate documentation. It was like a standard of how to design REST APIs in XML. WADL didn’t get popular, because using XML was inconvenient.
JSON pushed XML APIs off the scene, and Swagger brought the standard definitions: a schema. Now you can auto-generate RESTful API documentation from a swagger/OpenAPI specification file.
REST APIs became easier to build, fairly consistent, and aggregator tools make it possible to connect APIs.
The failure of Product management, in general, is the philosophy of “If you build it, they will come…”
API Product cycle (CI/CD tech stack): automation to generate good content and make it easier to provide updates to the APIs, API documentation, API libraries, SDKs on the developer portal. To get even the smallest updates automatically reflected, you first have to create a solid design: start with the OpenAPI schema and build from there.
Identify the problem
Research to understand the problem
Design
Implement -- if and after you have the OpenAPI schema
Launch the API and have an elegant Developer experience
Maintain & Iterate
obvious iterations and opportunities
“#APIs can boost business because it prepares you for digital ecosystems” - @KoenAdolfs. If you would like to know… https://t.co/Y9l5IGI37w
What should be the purpose of your #APIprogram? When does it become successful? Stay tuned because the new podcast… https://t.co/Z1GmsLUnA5
RT @APItheDocs: 🥁 Early-bird tickets are available for #APItheDocs #Amsterdam🥁 Save your spot and register for the 2-day conferenc… https://t.co/rFieLnreop
🥁We're launching a new #podcast series🥁 @kvantomme interviews guests from leading #API teams to explore a more hol… https://t.co/CT7UUXAxFc
They airdropped me $GPT WTH @wild_trent @SADA @Bitathon1 @SolarBrad14 @sainathyarra @pronovix @LFlecchia @luqmaansu… https://t.co/R5TSa9RGf2