Session

Automating the API Developer Experience Lifecycle

In short, we will discuss:

  • Managing your API Specs from choosing a format to merge multiple specs.
  • Auto-generating API docs, SDKs, code samples, test cases and tutorials.
  • Building a CI/CD pipeline to keep everything in sync with your API spec updates.

Description:

When talking about an automated developer experience lifecycle, it has to first be managed from the API Specification end. In an Enterprise, there is not just one person who is writing the API Specs, there are multiple API Engineers involved from multiple teams along with technical writers. We are going to talk about the concepts of overlays, where markdown content and API specification files both can be imported to generate API documentation & SDKs. The next step would then be merging different API Specs to generate one artifact.

After taking care of the API Spec part, the next part is helping 3rd party developers with the consumption of those APIs. Here we are going to auto-generate SDKs, code samples, test cases etc  in some common programming languages like Java, Python, C# and demo a use case of consuming the APIs using those SDKs. We will talk about developer experience as a whole, necessary components of it and how they can all be auto-generated.

The aforementioned steps will be performed through CI/CD on a commonly used platform (e.g., Openshift) to achieve end to end automation. We’ll demo from API spec update to automatically reflecting the changes to API docs to publishing SDKs as packages such as Nuget and gem files and/or pushing to a Git repo. This will ensure  an amazing developer experience for your internal API teamsl.

What to bring:

  • Your own laptop
  • Any public API spec

Key takeaways:

By the end of this workshop, you will know how to design your API specification flow in a way that ensures consistency and scalability for the future. You will get the complete understanding of the key components of an amazing developer experience and how you can automate the pipeline for it.

This session will be held at at our upcoming event:

SQL for Web APIs: Examples, Benefits, and Implementation

Learn More Register

What is the Difference Between Authentication and Authorization?

Learn More Register

The Difference Between HTTP Auth, API Keys, and OAuth

Learn More Register

Calculating the Total Cost of Running an API Product

Learn More Register

New eBook Released: API Strategy for Open Banking

Learn More Register

The Role of APIs in DevOps

Learn More Register

Event

Austin API Summit 2020

Time

May 4, 2020 1:00 PM

Location:

JW Marriott Austin

Duration:

4 hours including break

Smarter Tech Decisions Using APIs

API blog

High impact blog posts and eBooks on API business models, and tech advice

API conferences

Connect with market leading platform creators at our events

API community

Join a helpful community of API practitioners

API Insights Straight to Your Inbox!

Can't make it to the event? Signup to the Nordic APIs newsletter for quality content. High impact blog posts on API business models and tech advice.

Join Our Thriving Community

Become a part of the world’s largest community of API practitioners and enthusiasts. Share your insights on the blog, speak at an event or exhibit at our conferences and create new business relationships with decision makers and top influencers responsible for API solutions.