Re:Protobuf Editions are here: don't panic
by hot_gril on Thursday May 09, 2024 @07:12PM
(#40313864)
Performance aside, it's also really nice how a protobuf spec tells you what data structure to expect ahead of time for an API.
Re:Protobuf Editions are here: don't panic
by jon_richards on Thursday May 09, 2024 @07:23PM
(#40313923)
The number of APIs with a single JSON example as the only documentation is... unfortunate. Especially if you want to know if a field is nullable.
Taking this a bit further, it's surprising how many companies sell API as a service but provide minimal support for that API, publishing like 1 client/sdk (and often not in the language you need, lol).
Just mindblowing that companies don't adopt a schema-first approach to appeal to a broader customer base. I've lost count of the number of hnd rolled clients I've had to write over the years.
It gets even better if the API itself is backed by some RPC framework. With that, users can simply generate a client and get going.
It feels like we can do better as an industry, this cracked me up because it's so true.
"a single JSON example as the only documentation is... unfortunate"
Lord knows how much energy we are wasting turning binary data into human readable text that no human will ever look at before it's parsed back into binary.