“#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 2022 event series on 26 October. We are glad to present the video recording, slide deck and talk summary below. Enjoy!
Visit the talk listing page for an overview of all presentations!
Developer Advocate at Miro
”Trust is at the heart of deprecation”
Deprecation: The feature is no longer supported by the team. No new functionality will be released around that feature, and if there are any bugs or issues with the product, the chance that they will explore a fix is extremely low. (definition by Twitter Developer Platform)
Retirement: The feature will no longer be accessible. (definition by Twitter Developer Platform)
Healthy APIs and services are constantly evolving, and the capabilities that are available of the APIs today, could be outdated or no longer necessary to the product after some time. Old versions often are:
Less time and resources are spent at keeping them updated. This is where deprecation comes in: we need a way to handle these older versions, and ensure the developers and users are always able to use the latest and greatest capabilities.
Deprecation is a way to offload resources that were being used for older versions, so then you can actually focus on those that continually evolve and expand your latest versions.
The biggest risk at deprecation and retirement is being ambiguous.
Ambiguity includes:
The three most important things to consider:
Understanding the landscape:
When developers choose to leverage your APIs, they are putting their faith in your product, and also your team’s decision making.
If your expectations are different from what you see in reality, forcing a retirement just to meet an internal goal is not going to maintain the trust you have built with your developer ecosystem.
When it comes to retirement, you need to be realistic and don’t shoot off a critical infrastructure of your end users and developers just to meet an internal goal.
The solution is a balance between external needs of developers and internal commitments in your organization.
“#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