Let’s say I am writing a small thing, and I want to expose it as a simple JSON rpc. I value simplicity, so grpc and (I think) graphql are out.
If I want to define the API via language independent IDL, what are my choices? I know that JSON schema exists, but it doesn’t seem like a good IDL (not human readable, too much non-type based validation built-in, haven’t seen it actually being used in real world).
I kinda like the style LSP is defined in, via a bunch of TS interfaces, but that’s an informal subset.
Anything else to take a look at?