About 3,780 results
Open links in new tab
  1. OpenAPI Specification - Version 3.1.0 | Swagger

    The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without …

  2. What Is OpenAPI? | Swagger Docs

    What Is Swagger? Swagger is a set of open-source tools built around the OpenAPI Specification that can help you design, build, document, and consume REST APIs. The major Swagger tools include: …

  3. Get Started With The OpenAPI Specification - Swagger

    The OpenAPI Specification, formerly known as the Swagger Specification, is the world’s standard for defining RESTful interfaces. The OAS enables developers to design a technology-agnostic API …

  4. API Resources - Swagger

    The OpenAPI specification, formerly known as the Swagger Specification is the world’s standard for describing RESTful APIs. The specification creates a RESTful interface for easily developing and …

  5. OpenAPI Specification - Version 2.0 | Swagger

    The Swagger specification defines a set of files required to describe such an API. These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in …

  6. Paths and Operations | Swagger Docs

    In OpenAPI terms, paths are endpoints (resources), such as /users or /reports/summary/, that your API exposes, and operations are the HTTP methods used to manipulate these paths, such as GET, …

  7. Basic Structure | Swagger Docs

    The OpenAPI version defines the overall structure of an API definition – what you can document and how you document it. OpenAPI 3.0 uses semantic versioning with a three-part version number. The …

  8. Data Types | Swagger Docs

    In this example, {"id": 5, "username": "trillian"} matches the schema, but {"id": 5} does not. Files Unlike OpenAPI 2.0, Open API 3.0 does not have the file type. Files are defined as strings:

  9. Describing Parameters | Swagger Docs

    Each path parameter must be substituted with an actual value when the client makes an API call. In OpenAPI, a path parameter is defined using in: path. The parameter name must be the same as …

  10. Describing Responses | Swagger Docs

    An API specification needs to specify the responses for all API operations. Each operation must have at least one response defined, usually a successful response.