I have been working with our EPP REST API it's a really great API. Unfortunately the documentation has some obscure points. Here are some suggestions for improving the REST API documentation:
- The warn "All URL's below are relative to the REST management entry point of the portal container." is useful, but it doesn't mention what is the entry point. It would be great to know the entry point even if you use a clean installation as example;
- You should explore more the JSON part of the API. The JSON implements HATEOAS and after I found the first page I could navigate by all the API only using the HATEOAS feature;
- I would like suggest to give more examples using a clean EPP installation. The most good part of an API is to test it ;
- I wish we could have something like .org documentation.
That's it, these are my suggestions.