I would like to add Microsoft's API Guidelines [1] here, which is also a well written document and can be helpful to anyone designing an API.[1]: https://github.com/Microsoft/api-guidelines/blob/master/Guid... It's interesting that both of these guidelines kind of reject HATEOAS by mandating explicit versioning. It seems that HATEOAS was never really a thing. It's just too complicated to implement