Your thoughts on "/api.txt" are pretty similar to how a Hydra API can be discovered: https://www.hydra-cg.com/spec/latest/core/#discovering-a-hydra-powered-web-

Your thoughts on "/api.txt" are pretty similar to how a Hydra API can be discovered: https://www.hydra-cg.com/spec/latest/core/#discovering-a-hydra-powered-web-api https://www.hydra-cg.com/spec/latest/core/#discovering-a-hyd... Essentially, there can be a Link HTTP header to the "Entry-Point" document for the API, which further links to the vocabulary that describes the resources understood by the system and the actions you can perform on them. Link: <http://api.example.com/doc/>; rel="http://www.w3.org/ns/hydra/core#apiDocumentation" I recommend watching some of the talk videos listed on the hydra web page: http://www.hydra-cg.com/ http://www.hydra-cg.com/