UML / API : How to model a RESTful API

So the solution to my problem was a bit of all of the following :

https://www.ibm.com/developerworks/rational/library/design-implement-restful-web-services/ : I concluded from this that, although it's difficult to model a restful api in a class diagram (since it's basically just a bunch of methods), consider the classes like "Resources", add the methods (basically the HTTP methods), and the paths to each resource.

This was also of huge help:

• https://firstinfinity.wordpress.com/modeling_rest_web_services/

Another (simpler) way was to use tools like Pikturr, which transform your Swagger into a UML diagram.

Softwares for designing REST APIs :

• Visual Paradigm
• IBM Rational Software Architect

I hope this helps.

Api Platform automatically generates a Swagger documentation for your API at the URL http://localhost/docs.json.

You can generate an UML diagram from the Swagger documentation using tools like https://github.com/nrekretep/pikturr