The Criteria Blog

How to generate documentation for your REST API for free

Criteria Playground is a free tool for generating documentation for your REST API from an OpenAPI or Swagger file.

How to write JSON Schemas for your API Part 2: documenting fields

Learn how to document JSON Schemas to create a better experience for developers using your API.

Introducing Criteria Diagrams

Criteria Diagrams is a free tool for documenting your REST API as a flow diagram.

What’s new in Criteria — May 2023

New features in Criteria that were released in May 2023.

What is an API contract?

Learn what an API contract is and how it relates to other kinds of agreements between API providers and consumers.

REST API date format best practices

Best practices for formatting date and time fields in REST APIs.

What’s new in Criteria — April 2023

New features in Criteria that were released in April 2023.

Unlock consistent API design with Shared Components

Shared Components allow you to create and reuse standardized models across your API to achieve design consistency.

Introducing API Issues

Learn how API Issues can accelerate your API design process by automating your style guide and create consistency across teams.

How to write JSON Schemas for your API Part 1: validating data

Learn how to create JSON Schemas that documents field validation rules for your API.

What’s new in Criteria — February 2023

New features in Criteria that were released in February 2023.

Criteria now supports OpenAPI v3.1

Criteria now supports importing and exporting OpenaPI v3.1 files.

REST API design: best practices for returning Boolean values in responses

Why you should avoid returning responses that are just a true or false value and what to do instead to design more customer-centric APIs.

Twitter cuts off API access: 5 lessons from their ever-changing API strategy

A look back at Twitter’s API strategy over the years and lessons for your own API progam.

What is JSON Schema and how is it used in APIs?

Learn about JSON Schema, its use cases and benefits, and how it’s used in APIs.

Designing APIs for the customer: analyzing the Unsplash API

Understand how the Unsplash API has been designed to meet the needs of different types of customers.

6 industry trends driving the API economy

Learn about the trends in the software industry that are driving the API economy.

Criteria is now in Beta!

Announcing the Beta release of Criteria, the collaborative API design platform.

Getting video to autoplay using Next.js and Tailwind

How I got the demo video to autoplay on the website’s homepage using Next.js and Tailwind.