You can use OpenAPI/swagger to do that, which contains a subset of Json Schema, you have the option to use Yaml instead of json notation and have it language-independent and with the option to generate client and server code for multiple languages.