Articles

At APIdays Paris 2018, Ronnie Mitra gave an insightful talk on how to improve API documentation and learning experiences, for which he gathered inspiration from the Dreyfus model of skill acquisition.

In this post, we’ll dive a little deeper into the whole topic and illustrate Ronnie’s conclusions by giving an overview of content and DX elements we imagine would help developers along their learning journey.

The goal of the DevPortal Awards is to recognize the best developer portals and learn from their practices. In our previous post we already shared the jury’s reasoning for choosing the winners, but of course we were thrilled to hear the opinion of the other side, the teams that made their portal an awarded success!

What are the world's best devportals? What do they do differently? Are there any best practices that everybody could and/or should be doing? Our primary aim with the Devportal Awards was to answer these questions - or at least trigger a discussion about them.

Users today expect their music, videos and pictures to be available anywhere at anytime. Developers need APIs that can provide this to end users, but they also need developer portals that enable them to integrate these APIs into their applications as efficiently and quickly as possible. In this post we provide some great examples from a selection of such publicly available developer portals.

Most organizations never consciously address the experience of the developers that create APIs, the upstream. This is only logical, upstream Developer eXperience doesn’t always need attention: a team that is dedicated to APIs will overcome friction on its own terms. In large enterprise organizations, however, where API development might be a secondary priority of a team, upstream DX can make the difference between a failed and a successful digital transformation initiative.

The goal of our API Documentation Apprenticeship program is dual. It provides technical writer skills for our clients and it is an opportunity for novice API documentarians to gain credentials by working on enterprise projects under the guidance and supervision of experienced mentors.

In the third part of the series we focus on companies that provide APIs in the field of telecommunication. We included examples both from telecommunication carriers such as Orange or Telenor and from API vendors such as Nexmo or Twilio.

Infographic: What Is a Developer Portal? A trust signal for your API. A self-service hub. A dashboard for your API products. A list of endpoints is not enough.

The financing industry offers so many good examples of developer portals that after focusing on traditional banking APIs in the first part of our series, we felt the need to continue with various portals from the FinTech area. As opposed to banks, most companies in this group were born into the digital / API world.

PSD2 and a swarm of Fintech guerilla competitors are shaking up the banking sector. A large number of financial institutions decided to embrace the change, and to execute an Open banking strategy. As a direct result, a lot of new APIs and developer portals for banking services are now available on the public web. From the numerous developer portals we found, we’ve selected some of the best portals that demonstrate the innovations and best practices to enhance developer experience in the banking context.

In this series we will look into some of the best and most innovative practices developer portals from various industries use to anticipate on the possible expectations of developers.