Comment by Miki Szeles on "REST API Maturity Levels"

Miki Szeles

Everything related to test automation

Mar 9, 2022

Very insigtful article Rafael again. We are at level 2 at the moment. In addition to that we are using Swagger to document our API. As our API is only used internally and as we have documented APIs I do not see any added value by introducing HATEOAS. What do you think about this?😊

Rafael Câmara

Backend Developer

Mar 10, 2022

Thank you so much for your comment!

Regarding the question you made, in your case, I don't see any added value in introducing HATEOAS, because you say you have a well-documented API and it's only for internal use.

I have had experiences, in a similar situation, where documentation was poor, and having HATEOAS would've helped a lot in getting to know the API not only as fast as possible but in a deeper way.

If you had your API publically available, I would recommend HATEOAS because I think it would make the other developers' lives easier, but this comes with the cost of having a bit of extra work to give this "client" experience.

Thanks for your insigthful answer Rafael Câmara 😊

Search Hashnode