Either that or OpenAPI Specification (which is in some ways a superset of JSON Schema). At a previous job, we had OpenAPI specs that were mostly just schemas with a few endpoints defined. The tools around generating OpenAPI clients are robust and mature.