Documentation

Documenting Outbound APIs

How do you document the APIs your partners and customers need to build so you can interact with them?

Sep 29 •

Can a Mock Server be an API Sandbox?

What are the differences between a mock server and an API sandbox?

Sep 12 •

Machine-Oriented Use-Case Documentation

How can machines understand multi-step API use cases?

Aug 22 •

Documenting Your API Around Its Capabilities

How can consumers know what your API does if you're not showing its capabilities?

Aug 8 •

Defining Mock Data Using OpenAPI Overlays

You shouldn't have to change your OpenAPI to add examples.

Jul 18 •

Alternative Ways to Make Your APIs Discoverable

Make consumers happier by making it easier to find and use your APIs.

Jun 25 •

Can TypeSpec Be an Alternative to OpenAPI?

Switching from OpenAPI to TypeSpec might be a viable solution.

Jun 13 •

Referencing a Tutorial for Each OpenAPI Operation

The best place to teach people is where they go to learn.

May 28 •

How to Automate API Documentation

Can documentation be automatically updated whenever the API changes?

May 16 •

Adding Semantic Information to Your OpenAPI Description

Helping machines navigate your API results shouldn't be complicated.

Apr 25 •

Documenting API Governance

How do you document the processes behind API governance?

Apr 10 •

Three Meaningful API Metrics

How can you improve an API if you're not measuring its behavior?

Mar 21 •

#nojs-banner { position: fixed; bottom: 0; left: 0; padding: 16px 16px 16px 32px; width: 100%; box-sizing: border-box; background: red; color: white; font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 13px; line-height: 13px; } #nojs-banner a { color: inherit; text-decoration: underline; } This site requires JavaScript to run correctly. Please turn on JavaScript or unblock scripts