[TranquilMarmot]

We've had pretty good success with using OpenAPI Specifications to document APIs and their schemas and then using generated clients in code.