[ozim]

If only there would be something with schema like XML that people would use for the APIs ;) You could generate diagrams from WSDL and even generate client code from that.

There is also bunch of JSON schema stuff nowadays.

But yeah for a lot of people schema of API contracts feels like too much work and too much hassle.

JSON serialization doesn’t throw errors for new properties quickly added on sending side and receiving side can ignore stuff - well as long as API semantics allow but that’s generally going to be a hassle always even with LLMs somehow autofixing your „schema”.