OAI/OpenAPI-Specification on Hacker News

▲ 2

story by mooreds · 2026-07-05 · 0 comments

Referring to OpenAPI: https://github.com/OAI/OpenAPI-Specification

comment by edweis · 2025-02-20 · in Show HN: A Fast HTTP Request CLI Powered by HTTL

▲ 2

story by tmvnty · 2024-10-28 · 1 comment

…error handling that make it impossible. [1] https://www.npmjs.com/package/@protobuf-ts/protoc [2] https://github.com/OAI/OpenAPI-Specification/issues/2617#iss...

comment by no_circuit · 2023-11-16 · in The reason to use Protobuf is not performance

…bodies I wanted to draw your attention to "normal" POST application/x-www-form-urlencoded < https://github.com/OAI/OpenAPI-Specification/blob/3.1.0/vers... > and its multipart/form-data friend < https://github.com/OAI/OpenAPI-Specification/…

comment by mdaniel · 2023-10-25 · in Show HN: OpenAPI DevTools – Chrome extension that generates an API spec

…pet store example to compare. - https://github.com/project-flogo/grpc/blob/master/proto/grpc... - https://github.com/OAI/OpenAPI-Specification/blob/main/examp...

comment by sa46 · 2022-10-31 · in Protobuf-ES: Protocol Buffers TypeScript/JavaScript runtime

▲ 1

Ask HN: Non-Breaking API deprecation in OpenAPI spec – what do you think?

story by lonelygiraffe · 2022-08-17 · 0 comments

…s://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...

comment by progval · 2022-04-23 · in Is XMPP any good? Also, let's write a client in Tcl, maybe

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.

comment by 0xcoffee · 2022-04-04 · in HTTP Feeds

…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…

comment by Klaster_1 · 2022-02-27 · in Ask HN: How well do your front end and back end teams work together?

…thousands of open bugs, isnt going anywhere, moves very slowly and is missing fundamental features. https://github.com/OAI/OpenAPI-Specification/issues/1998 heres the ticket where it will inevitably be ignored and die. But even if it was…

comment by adamscybot · 2021-02-22 · in Best practices for REST API design (2020)

…"select all schemas used in this path" or "select the count of references to this parameter". [1] https://github.com/OAI/OpenAPI-Specification/blob/master/ver...

comment by disposedtrolley · 2020-07-19 · in Turning the IDE Inside Out with Datalog

…is so different from HTTP (and has some tradeoffs) that I'd understand not even considering it. 1. https://github.com/OAI/OpenAPI-Specification/issues/523

comment by smt88 · 2020-07-14 · in Show HN: Buttery, a DSL/runtime for defining HTTP APIs

…specification for the sample application (petstore) with service and model definitions in YAML - https://github.com/OAI/OpenAPI-Specification/blob/master/exa... .

comment by smoyer · 2020-04-16 · in Show HN: Verify JSON using minimal schema

I would love if the definition of websockets would be added to OpenAPI https://github.com/OAI/OpenAPI-Specification/issues/523

comment by dsun180 · 2020-03-30 · in AsyncAPI – OpenAPI-like specification for event-driven architectures

▲ 4

Show HN: Auto-Generate Scala API Clients for REST APIs

story by wing328hk · 2020-03-04 · 0 comments

▲ 69

OpenAPI 3.0.3 Specification Released

story by izbob · 2020-02-21 · 59 comments

▲ 1

OpenAPI Generator's Kotlin client generator now supports multiplatform

story by wing328hk · 2019-09-27 · 0 comments

…/ client generation. [0] https://philsturgeon.uk/api/2018/04/13/openapi-and-json-sche... [1] https://github.com/OAI/OpenAPI-Specification/issues/1532 [2] https://quicktype.io/typescript/

comment by acemarke · 2019-04-14 · in Using JSON Schema to Document, Test, and Debug APIs

…is: Use standards and don't reinvent the wheel. There are plenty of them... https://jsonapi.org/ https://github.com/OAI/OpenAPI-Specification http://json-schema.org/ https://graphql.org/learn/ ... And for authentication and authorisation…

comment by sandreas · 2019-02-06 · in Ask HN: How do you prefer to structure web APIs?

▲ 1

The OpenAPI Specification

story by nkjoep · 2017-12-15 · 0 comments

…has been true for at least a year, is the news that v3 is now 'current' rather than in development? https://github.com/OAI/OpenAPI-Specification

comment by OJFord · 2017-10-23 · in Swagger is now the OpenAPI Specification

…with MS Word. [1] http://www.django-rest-framework.org/ [2] https://paw.cloud/client [3] https://github.com/OAI/OpenAPI-Specification/blob/master/ver... [4] http://www.yaml.org/ [5] https://github.com/yoshiki/yaml-mode [6]…

comment by michaelsbradley · 2017-10-23 · in Swagger is now the OpenAPI Specification

▲ 2

The OpenAPI Specification v3.0.0 has been released

story by Meic · 2017-07-26 · 0 comments

if you implement swagger (now openapi) then you put the discovery in: https://github.com/OAI/OpenAPI-Specification/blob/master/ver...

comment by liveoneggs · 2017-03-31 · in Studio Ghibli API

…instead, which supports 30+ API clients and 20+ server stubs as well as API documentations. [1] https://github.com/OAI/OpenAPI-Specification [2] https://github.com/swagger-api/swagger-codegen Disclosure: I'm a top contributor to Swagger…

comment by wing328hk · 2017-03-10 · in Django REST framework 3.6 released

…webhooks. This is slated to change in an upcoming version of the OpenAPI-specification. Check out https://github.com/OAI/OpenAPI-Specification/pull/763 to see details. As soon as this is released, it only be a matter of time before Swagger…

comment by simo9000 · 2016-11-22 · in Webhooks do’s and dont’s: what we learned after integrating APIs

Noticed the same thing. After some digging I found what appears to be the latest draft spec here: https://github.com/OAI/OpenAPI-Specification/blob/master/ver...

comment by porpoisemonkey · 2016-03-11 · in The Open API Initiative

There does appear to be an examples section in the project repository https://github.com/OAI/OpenAPI-Specification/tree/master/exa...

comment by porpoisemonkey · 2016-03-11 · in The Open API Initiative

In this page: https://github.com/OAI/OpenAPI-Specification/tree/OpenAPI.ne... The link to current specification is broken Review the [current specification]. The human-readable markdown file is the source of truth for the specification.

comment by Oras · 2016-03-11 · in The Open API Initiative

…for API docs and can be used for auto generating API client libraries/SDKs. Here's an example: https://github.com/OAI/OpenAPI-Specification/blob/master/exa...

comment by wise_young_man · 2016-01-02 · in Introducing the Open API Initiative

If you're interested in re-use in Swagger, see the guidelines here: https://github.com/swagger-api/swagger-spec/blob/master/guid...

comment by earth2marsh · 2015-09-10 · in RAML – RESTful API modeling language

Swagger added support for examples with version 2.0 of the format, see: https://github.com/swagger-api/swagger-spec/blob/master/vers...

comment by earth2marsh · 2015-09-10 · in RAML – RESTful API modeling language

▲ 3

Swagger Rest API Server and Client Generator

story by davidjnelson · 2015-08-16 · 0 comments

…provide new functionality via new resources, and resources with discover-ability for auto RPC. https://github.com/swagger-api/swagger-spec/

comment by krob · 2015-03-28 · in A standard for building APIs in JSON

…to write API spec, it has tons of tooling to take a given spec to the next level. See the list at https://github.com/swagger-api/swagger-spec . My favorite is Swagger Editor which allows you to write a spec in YAML and shows you consumable…

comment by prabhatjha · 2015-01-19 · in Ask HN: What's the best way to write an API spec?

…Heroku doing so as well (not exhaustive list, just what I've found while searching). Helpful links: https://github.com/swagger-api/swagger-spec/blob/master/vers... Powerful array of tools to enable wrappers for Go, Scala, Flash, Java,…

comment by kevinconroy · 2014-12-15 · in An experimental, automatically generated set of AWS clients in Go

Thanks. Here's GitHub link for others interested like me: https://github.com/swagger-api/swagger-spec

comment by kevinconroy · 2014-12-15 · in An experimental, automatically generated set of AWS clients in Go