Mike Amundsen

Author of "Design and Build Great APIs"

Mike Amundsen

An internationally known author and speaker, Mike Amundsen travels the world consulting and talking about network architecture, Web development, and the intersection of technology and society. He works with companies large and small to help them capitalize on the opportunities APIs, Microservices, and Digital Transformation present for both consumers and the enterprise.

Presentations

AI-Driven API Design ( Part 1)

This pair of presentations (90 mins each) teaches you how to leverage AI tools like ChatGPT to optimize the design, documentation, and testing of web APIs. As AI becomes increasingly crucial in software development, this course will equip you to integrate AI-assisted automation into human-driven API design.

By the end of this two part workshop, you will be able to leverage AI to generate structured API documentation, automate security profiling, and produce comprehensive API test scripts, significantly improving efficiency and accuracy. Participants will see real-world exercises, including AI-assisted vocabulary extraction, OpenAPI generation, and automated test scripting, to gain practical experience in AI-powered API development.

Workshop Objectives:

  How AI can assist in API development, from design to testing.  

  Methods to extract API vocabulary using AI from user stories.  

  How to generate OpenAPI specifications with minimal manual effort. 

  Techniques to automate the creation of human-friendly API documentation. 

  How AI can assist in identifying security risks and generating security profiles.  

  Best practices for using AI-generated API test scripts.  

  How to integrate AI-driven automation into an API development workflow.

Part 1 : Basics of AI-Driven API Design

  Course Introduction

  Course Outline

  Goals and format

  "Play-along" with the repo

  Design Basics

  Story

  Vocabulary

  Diagram

  Description

  Definition

  AI Prompt / Context Engineering

  Conversation

  Context

  Memory

  Tips

  Authoring API Stories

  Stories are shared understanding

  Parts of an API Story

  Iterating on your API Story

  Exercise: The Task Management API Story

  Generating ALPS Design Docs

  Information Architecture

  Application-Level Profile Semantics

  ALPS Basics

  Exercise: Generating Designs with API Stories

  Generating OpenAPI Documents

  A formal standard for describing HTTP APIs.

  Common way to describe implementations

  Common platform for tooling

  Shared practice for building 

  Exercise: Generating AopenAPI

AI-Driven API Design ( Part 2)

This pair of presentations (90 mins each) teaches you how to leverage AI tools like ChatGPT to optimize the design, documentation, and testing of web APIs. As AI becomes increasingly crucial in software development, this course will equip you to integrate AI-assisted automation into human-driven API design.

By the end of the workshop, you will be able to leverage AI to generate structured API documentation, automate security profiling, and produce comprehensive API test scripts, significantly improving efficiency and accuracy. Participants will see real-world exercises, including AI-assisted vocabulary extraction, OpenAPI generation, and automated test scripting, to gain practical experience in AI-powered API development.

Course Objectives:

  How AI can assist in API development, from design to testing.  

  Methods to extract API vocabulary using AI from user stories.  

  How to generate OpenAPI specifications with minimal manual effort. 

  Techniques to automate the creation of human-friendly API documentation. 

  How AI can assist in identifying security risks and generating security profiles.  

  Best practices for using AI-generated API test scripts.  

  How to integrate AI-driven automation into an API development workflow.

Extending your AI-Driven API Design Experience

  Part 1 Quick Review

  API Design Basics

  AI Prompt Engineering

  Authoring API Stories

  Generating ALPS Design Docs

  Generating OpenAPI Documents

  Generating API Documentation

  What are Docs?

  Who uses them?

  Basic Elements of API Docs

  Exercise: Generate starter documentation

  Generating a Working Prototype

  What is a Prototype?

  Why use them?

  Prototype Essentials

  Exercise: Generate a NodeJS prototype

  Generating API Tests

  "Outside-In" testing

  Validating inputs/outputs

  Confirming Interface Behavior

  Exercise: Generating API Tests

  Generating Security Profiles

  API Security Basics

  RBAC to the rescue

  Modifying Existing Design Assets

  Exercise: Update Story, Generate Profile, regenerate, other assets

  Course Review and Next Steps

  Review Part 1 (design, AI, ALPS, & OpenAPI)

  Review Part 2 (docs, code, tests, & security)

  What Next?

Design and Build Great Web APIs

This session covers key skills for creating consistently successful APIs and simple tools that you can use to turn those skills into working models, sketches, and running code.

Based on the book “Design and Build Great APIs”, this presentation shows the important balance between designing, building, and releasing APIs and how to create a consistent process for your company that ensures your API teams produce quality APIs that developers can easily use to provide timely business solutions for your organization.

You'll learn now to:

  Write API stories

  Diagram APIs with Web Sequence Diagrams

  Describe APIs with ALPS Profiles

  Generate multiple working API Sketches with API Blueprint

  Select a candidate sketch to Prototype with OpenAPISpec

  Build a fully-functional API using NodeJS, Express, and the DARRT framework

  Test APIs with Postman and Newman

  Deploy your API to production