API Spec

What is a API Spec?

API Spec Designer is a comprehensive feature that allows you to meticulously design every aspect of an API contract. It provides a structured, step-by-step process to define an endpoint's behavior, parameters, and data payloads, ensuring that both frontend and backend teams are perfectly aligned. The designer is organized into four distinct sections.

Description

Key Capabilities

General

General section sets the API's unique signature, including its URL path and the HTTP method that defines its action. You also configure required HTTP headers here, which are essential for aspects like authentication and content type.

Parameters

This section lets you define URL parameters, including dynamic Path variables and optional Query strings for filtering. The system then automatically generates a code model from your query params for developers.

Request Body

Request Body section is where you define the data payload sent to the API using a visual JSON editor. From this definition, the system generates consistent, ready-to-use code models for both your frontend and backend.

Response Body

Response Body section defines the structure of the data payload the API returns after a request is processed. Like the Request Body, it uses a JSON definition to generate code models, making the response easy for the client to use.

Documentation Export

This feature is perfect for generating hand-off materials for client delivery, providing clear specifications for quality assurance (QA) teams, or for use in internal architectural reviews.