openapi
Mocking APIs with Microcks
Learn how to work with a powerful API mocking tool: Microcks, and how to integrate it with your existing API documentation flow.
api-design
API Design Basics: Pagination
How to handle pagination in your REST API, and what are the pros and cons of each method?
api-design
API Code-first: How to Generate OpenAPI from Code
An update on the API Code first or Design first debate, with some modern tools making a slightly nicer version of the Code first workflow, and better modern design first tooling.
api-design
How to Build a Perfect API Description
Learn what best practices and tooling you can use to build the best quality OpenAPI documentation from somebody who has been doing it forever.
api-design
Battle of the API Ratings: API Insights vs Rate my API
Dive into a detailed comparison of Trebble's API Insights and Zuplo's Rate my API, exploring their unique approaches to evaluating API design, performance, and security. Learn how these tools can elevate your API governance and design, ensuring a robust, efficient, and secure API experience.
openapi
Utilize AI for API Governance with LintGPT
LintGPT from Optic is the latest way to automate your API Style Guides, combining API Linting with ChatGPT in a way that's not just buzzword nonsense.
api-design
Make Your API Idempotent, Avoid Ruining Clients Lives
Explore idempotency in HTTP, highlighting its importance in preventing unintended effects of repeated actions. Learn how methods like GET, PUT, and DELETE inherently support idempotency, ensuring consistent results.
api-design
Modern OpenAPI Tooling for the entire API Lifecycle
Step into the future of API tooling with this video Phil Sturgeon recorded for Treblle's Hacktoberfest called "Modern OpenAPI Tooling."
api-design
How to Capture Quite a Lot of API Traffic
When rewriting an API, it's critical to make sure you don't change the shape of your inputs and outputs unexpectedly. After all, API specs are called contracts for a reason. This article outlines an approach to capturing API traffic using Optic for just this purpose.
openapi
Turn HTTP Traffic into OpenAPI with Optic
Capture real HTTP traffic from production or anywhere else, and create OpenAPI from it, for documentation, mocks, SDKs, or contract testing.