Awesome GitHub RepositoriesAPI Specification Tools

The OpenAPI Specification is a formal, vendor-neutral standard for defining the structure, endpoints, and data models of HTTP-based web services. By providing a machine-readable interface definition language, it enables developers to establish clear API contracts that ensure consistency across diverse programming languages and backend systems. This specification promotes a design-first development approach, where interface behavior is defined through static, declarative configuration files rather than imperative code. This structure allows for the automated generation of type-safe client libr

Redoc is an API documentation generator that transforms standard API specification files into interactive, responsive, and highly customizable web-based documentation interfaces. It provides a three-panel layout that includes synchronized navigation, code samples, and search functionality, allowing developers to explore endpoints and schemas directly within a browser-based environment. Beyond rendering, the project functions as an API governance toolkit that enforces structural standards and quality rules across API definitions. It includes a suite of processing utilities for bundling, splitt

eShop is a .NET microservices reference application that provides a comprehensive blueprint for a distributed retail system. It implements an e-commerce architecture using decoupled services to manage core operations such as product catalogs, shopping baskets, and order processing. The project demonstrates a cloud-native retail infrastructure that incorporates an asynchronous event bus system to synchronize state across distributed services. It includes a reference implementation for integrating generative AI features by connecting the store to large language models via cloud providers. The

api-blueprint is a markdown-based API design language and specification standard used to define the structure, behavior, and data schemas of HTTP web services. It provides a formal method for mapping HTTP methods to resources and defining payload validation rules through a machine-readable syntax. The project functions as a blueprint for creating interactive technical documentation and functional mock servers. These tools transform design specifications into human-readable guides and simulated backend environments to enable integration testing before implementation. The language covers API m

openapi-devtools est une extension de navigateur et un générateur de spécifications OpenAPI qui capture le trafic réseau pour documenter automatiquement les structures d'API des sites web et des applications. Il fonctionne comme un outil de capture de trafic HTTP et de documentation basé sur le navigateur, mappant les requêtes réseau en temps réel vers des spécifications d'API standardisées. L'outil permet l'ingénierie inverse d'API en interceptant le trafic HTTP sortant et en utilisant une fusion basée sur des heuristiques pour combiner les en-têtes, les corps et les paramètres de plusieurs requêtes en définitions de points de terminaison unifiées. Ces définitions capturées peuvent être visualisées sous forme de documentation lisible par l'homme dans le navigateur ou exportées sous forme de fichiers téléchargeables et de chaînes partageables. Le projet couvre l'intégralité du flux de travail de mappage des requêtes réseau, de la génération de spécifications côté client et de la persistance basée sur l'état jusqu'à l'exportation finale de la définition d'API.

Dredd is an HTTP API contract testing tool and specification validator. It functions as an automated test runner that verifies whether a live backend server's behavior adheres to a formal API specification document. The system performs language-agnostic API testing by transforming specification definitions into HTTP requests and matching the resulting responses against the defined JSON schemas. This process ensures that the server implementation remains compliant with the design contract regardless of the programming language used to build the backend. The tool manages the test lifecycle thr

Spectral is a programmable linting engine and validation tool designed to enforce style guidelines and schema correctness within OpenAPI specifications and JSON configuration files. It functions as a rule-based validator that analyzes structured text files to ensure data consistency and adherence to predefined constraints. The engine utilizes a configuration-driven execution model, allowing users to manage pluggable rule sets and integrate JSON Schema definitions. It supports the creation of custom function-based rules to define complex validation logic beyond static declarations. The projec

This project provides a web-based integrated development environment for defining, documenting, and simulating software interface specifications. It serves as a browser-based modeling tool that enables teams to create structured API contracts using the RAML modeling language. The environment distinguishes itself through its modular design, which allows the modeling interface to be embedded directly into existing web applications and developer portals. It supports a plugin architecture that enables the integration of custom persistence layers and metadata handlers, allowing teams to attach pro

Swagger Search is an application that aggregates the Swagger/OpenAPI documentation of your microservice architecture in one place, where your can browse it or search endpoints based on their url, documentation, the parameters it accepts or their types.

This SwaggerProvider can be used to access RESTful API generated using Swagger.io

A JSON schema validator for OpenAPI specifications, it currently supports:

Parses Swagger specs in JSON or YAML format - Validates against the Swagger 2.0 schema or OpenAPI 3.0 Schema - Resolves all $ref pointers, including external files and URLs - Can bundle all your Swagger files into a single file that only has internal $ref pointers - Can dereference all $ref…

A module to build validators for Swagger(OpenApi) Request parameters and Response objects.