4 ms·
A subjective opinion, but it's much easier to read some documentation and checking maybe an OpenAPI spec than having to deal with protobuf. You also have solut
by arein3 4y ago
A subjective opinion, but it's much easier to read some documentation and checking maybe an OpenAPI spec than having to deal with protobuf.
You also have solutions like GraphQL that define a schema, or you can publish some kind of schema (a good thing to do) but use JSON instead of a binary format.
- zeroq 4y agoType checking and schema are two different things. Both your application and documentation will assume certain state to be true, but only with type checking you can actually verify if it's correct.
- sa46 4y agoI prefer reading proto files with services over OpenAPI yaml. Here's the pet store example to compare. - https://github.com/project-flogo/grpc/blob/master/proto/grpc2grpc/petstore.proto https://github.com/project-flogo/grpc/blob/master/proto/grpc... - https://github.com/OAI/OpenAPI-Specification/blob/main/examples/v3.0/petstore.yaml https://github.com/OAI/OpenAPI-Specification/blob/main/examp...