Re:Why isn't there a Swagger/OpenAPI for binary formats?
by woodrowbarlow on Friday March 25, 2022 @04:35PM
(#30806786)
grpc is a layer on top of protobuf
[ Parent
| on HN ]
Re:Why isn't there a Swagger/OpenAPI for binary formats?
by pianoben on Friday March 25, 2022 @05:25PM
(#30807196)
In my view, gRPC is the closest "binary" analog to OpenAPI, which is a transport-layer concern first and foremost with discoverability features.
If your problem space is "a way to assign meaning to arbitrary bitfields", I don't feel that OpenAPI is a very good comparison. Its purview is "representing web APIs in terms of structured JSON/XML payloads". That is, OpenAPI also deals in logical and not physical representation. (unless it specifies UTF-8 or something - it might, I don't know!)
Re:Why isn't there a Swagger/OpenAPI for binary formats?
by woodrowbarlow on Friday March 25, 2022 @05:31PM
(#30807248)
you know, i think you're right. on reflection, a comparison to json schema[1] (rather than openapi) would be more appropriate, as mentioned be defanor in another comment.
Re:Why isn't there a Swagger/OpenAPI for binary formats?
by cbsmith on Saturday March 26, 2022 @05:57AM
(#30810545)
> In my view, gRPC is the closest "binary" analog to OpenAPI, which is a transport-layer concern first and foremost with discoverability features.
Well, it and every other binary RPC technology...
Re:Why isn't there a Swagger/OpenAPI for binary formats?
by randomdata on Friday March 25, 2022 @04:45PM
(#30806870)
Extending it to define transport concerns, akin to Swagger/OpenAPI.