Documentation

Everybody Wants to Have an API Product

API-as-a-Product is a journey and not the final destination.

Jan 7 • Bruno Pedro

Generating an API README with AI

Is AI capable of generating a good-quality API README?

Dec 19, 2025 • Bruno Pedro

API Prototyping in Practice

What techniques can help you validate your APIs?

Dec 6, 2025 • Bruno Pedro

Behind the APIs with Scalar at apidays Paris

Meet the people shaping the future of APIs.

Nov 15, 2025 • Bruno Pedro

API Prototypes Need Persistent Operations

API prototype operations should be able to mutate data.

Oct 24, 2025 • Bruno Pedro

Just-in-Time API Prototyping

Can API prototyping be an incremental process?

Oct 10, 2025 • Bruno Pedro

Documenting Outbound APIs

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

Sep 29, 2025 • Bruno Pedro

Can a Mock Server be an API Sandbox?

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

Sep 12, 2025 • Bruno Pedro

Machine-Oriented Use-Case Documentation

How can machines understand multi-step API use cases?

Aug 22, 2025 • Bruno Pedro

Documenting Your API Around Its Capabilities

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

Aug 8, 2025 • Bruno Pedro

Defining Mock Data Using OpenAPI Overlays

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

Jul 18, 2025 • Bruno Pedro

Alternative Ways to Make Your APIs Discoverable

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

Jun 25, 2025 • Bruno Pedro

#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