My issue with rest api tools is that for some reason people use them to test API request/response flows instead of coded integration tests.

For API specification we have OpenAPI specification[1] (formerly known as Swagger specification).

[1] https://swagger.io/specification/