OpenAPI-Specification Alternatives

Similar projects and alternatives to OpenAPI-Specification

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a better OpenAPI-Specification alternative or higher similarity.

Suggest an alternative to OpenAPI-Specification

OpenAPI-Specification reviews and mentions

Posts with mentions or reviews of OpenAPI-Specification. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2022-04-23.
  • Is XMPP any good? Let's write a client in Tcl, maybe
    2 projects | news.ycombinator.com | 23 Apr 2022
    > JSON has no namespaces

    Causing all extensible JSON-based protocols to eventually reinvent them:

    * https://www.w3.org/TR/json-ld11/#compact-iris

    * "If new events are added, the event type key SHOULD follow the Java package naming convention, e.g. com.example.myapp.event." https://spec.matrix.org/v1.2/client-server-api/#types-of-roo...

    * https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-22... (no aliases, so it's even more verbose)

    * https://github.com/OAI/OpenAPI-Specification/issues/1362#iss...

    > it maps nicely into lists and dicts

    and XML maps nicely into structures and vectors when you have a schema. But structures and schemas fell out of fashion, in favor of dynamically querying dicts.

  • HTTP Feeds
    2 projects | news.ycombinator.com | 4 Apr 2022
    100% onboard with better tooling.

    Starting with out of the box swagger support: https://github.com/OAI/OpenAPI-Specification/issues/396

    Shame they are not interested in adding it.

  • How to Build Lightning Fast APIs with AWS Step Functions
    3 projects | dev.to | 30 Mar 2022
    I am a big proponent of using Open API Spec (OAS) to define your serverless APIs. In our example, we will be using VTL to connect API Gateway to Step Functions via our OAS.
  • FastAPI vs. Flask: Comparing the Pros and Cons of Top Microframeworks for Building a REST API in Python
    5 projects | dev.to | 26 Mar 2022
    The most common standard for creating such documentation is OpenAPI and JSONSchema.
  • Using Swagger API
    6 projects | dev.to | 18 Mar 2022
    We had one use case that is still not supported by Swagger Codegen, though. We would really like to use inheritance in our data model. The Swagger specification has properties for specifying inheritance, but it hasn't made its way into Codegen yet and there might still be some unresolved edge cases in the Swagger specification (#403).
  • Ask HN: How well do your front end and back end teams work together?
    1 project | news.ycombinator.com | 27 Feb 2022
    Sometimes smooth, sometimes not so.

    We use FETCH/HTTP and STOMP/WS to move the data, the main issue has always been spotty communication inside the team. A while ago, the situation was even worse, so some progress did happen. OpenAPI annotations to generate Swagger docs helped a bit, but I rarely bother to open these. Drafting endpoint signatures in TypeScript as a part of our workflow yielded great results, something concrete to talk about when things don't work as expected or during code reviews. Unfortunately, the agreements are as good as initial requirements, if the team does not understand or communicate these clearly, misunderstands are bound to happen. The other pain point is that OpenAPI only supports HTTP (https://github.com/OAI/OpenAPI-Specification/issues/55), there's no documentation for STOMP endpoints and custom RPC run over it. Another thing is when signatures change unexpectedly (I know, this should never happen; at least integration tests help here) in subtle ways and the UI suddenly starts misbehaving; types shared between frontend (TypeScript) and backend (Java) can partially alleviate the issue, but none of available tools provide what I'd really like to use, the results are either not expressive enough (no ADTs, unlike types authored by hand) or really hard to reconcile with existing code base.

  • Autogenerated documentation API with OpenAPI and Swagger for NodeJS and Express
    1 project | dev.to | 14 Feb 2022
    There are OpenAPI for good patterns and Swagger for help us to generate the documentation using OpenAPI.
  • Log Connexion request body
    2 projects | dev.to | 5 Feb 2022
    Connexion is a framework on top of Flask that automagically handles HTTP requests defined using OpenAPI
  • what are the best tools for documenting apis?
    6 projects | reddit.com/r/api | 21 Jan 2022
    It depends on the type of API. REST APIs are documented with the OpenAPI specification standard. If it's a GraphQL API, you use the Schema Definition Language. gRPC uses Protocol Buffers. Each type of API has its own documentation standard. There's also a specification for event-driven APIs called AsyncAPI!
  • FastAPI : le nouveau framework web pour vos API avec Python
    5 projects | dev.to | 2 Dec 2021
  • API implementation generator for Flutter. Put Swagger.json URL or OpenAPI JSON and download all models and endpoints as classes and methods ready to use
    2 projects | reddit.com/r/FlutterDev | 22 Nov 2021
  • IRIS API Explorer Application
    3 projects | dev.to | 19 Nov 2021
    OpenAPI initiative (https://www.openapis.org/) is the organization supporting a standard specification to define APIs (https://github.com/OAI/OpenAPI-Specification). The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.
  • How to test APIs??
    8 projects | reddit.com/r/commandline | 10 Nov 2021
  • Yancy: What We Leave Behind
    3 projects | dev.to | 3 Nov 2021
    Last, the OpenAPI spec was how the frontend app analyzed the data schema to determine what it could do. However, since every schema can only do the same four operations (create, read, update, and delete), reading the OpenAPI spec to handle operations is needless complexity. The generated API could be used by more than just the Yancy editor, so the code for generating OpenAPI specs from Yancy schemas has been moved to the Yancy::Plugin::OpenAPI module on CPAN.
  • OpenAPI spec (swagger) v2 vs v3
    1 project | dev.to | 26 Aug 2021
    A number of requests were made to expand the subset of JSON Schema that the OpenAPI spec allows to include more complex features of JSON Schema. In the 2.0 spec process, the potential tooling complexities around code generation prompted the exclusion of anyOf and oneOf. However, many users have requested relaxing that constraint, even though it would compromise tooling support for those features. This is one of the great challenges in spec design, and it is never easy when making choices like this to know whether it is better to give people sharp tools that they could cut themselves with, or to rely on experience to say no, the burden of this responsibility is too great. While OpenAPI 2.0 took the more conservative approach, the user base has grown more experienced, so some of the restrictions are being lifted, and users will have to make smart choices.

Stats

Basic OpenAPI-Specification repo stats
23
23,818
7.3
about 1 month ago

OAI/OpenAPI-Specification is an open source project licensed under Apache License 2.0 which is an OSI approved license.

Less time debugging, more time building
Scout APM allows you to find and fix performance issues with no hassle. Now with error monitoring and external services monitoring, Scout is a developer's best friend when it comes to application development.
scoutapm.com
Find remote JavaScript jobs at our new job board 99remotejobs.com. There are 4 new remote jobs listed recently.
Are you hiring? Post a new remote job listing for free.