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 is a browser extension and OpenAPI specification generator that captures network traffic to automatically document the API structures of websites and applications. It functions as an HTTP traffic capturer and browser-based documentation tool, mapping real-time network requests into standardized API specifications. The tool enables API reverse engineering by intercepting outbound HTTP traffic and using heuristic-based merging to combine headers, bodies, and parameters from multiple requests into unified endpoint definitions. These captured definitions can be visualized as huma

Dredd este un instrument de testare a contractelor HTTP API și un validator de specificații. Acesta funcționează ca un runner de teste automatizat care verifică dacă comportamentul unui server backend live respectă un document de specificație API formal. Sistemul efectuează testarea API agnostic față de limbaj prin transformarea definițiilor de specificație în cereri HTTP și potrivirea răspunsurilor rezultate cu schemele JSON definite. Acest proces asigură că implementarea serverului rămâne conformă cu contractul de design, indiferent de limbajul de programare utilizat pentru a construi backend-ul. Instrumentul gestionează ciclul de viață al testelor prin orchestrarea scripturilor externe de setup și teardown. Aceste hook-uri agnostice față de limbaj permit configurarea mediului de testare și menținerea stării între testele individuale de validare.

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.