One benefit of API documentation is the ability of running implementation tests against the serving party (backend) and thus ensuring conformity.
One solution is for example Schemathesis.
Reference
Laforge, G. (2016, April 27). (How Far Should API Definition Languages Go? | Nordic APIs |. Nordic APIs. https://nordicapis.com/how-far-should-api-definition-languages-go/