# Overview

OpenAPI provides a common framework for designers, developers, testers, and devops to build and maintain REST APIs. It automatically generates a specifications page that documents the REST endpoints and provides a tool to execute them with appropriate parameters. The consumers can understand and connect with the API remote services without the need to understand the implementation logic.

This document will specify the integration of REST endpoints that Hasura uses/generates with the OpenAPI specifications and generate json/yaml accepted by OpenAPI standards to design, build, document, test and standardize REST API endpoints.

# Why integrate OpenAPI?

* Helps in collaborative API development
* OpenAPI definitions can be converted to code using tools like swagger-codegen
* Provides machine-readable definitions, providing easy testing
* Generates interactive documentation integrated with test UI clients

# Specification

# Future Work

Shdkjnckajawmqlkde

# Puru