API RESTfull Best Practice
Use this simple and well done website as reference http://www.restapitutorial.com and feel free to augment with other solutions taht you can find online
Proposed structure
- What is a rest http://www.restapitutorial.com/lessons/whatisrest.html talk about al these items => The six constraints are
- Rest quick tips http://www.restapitutorial.com/lessons/restquicktips.html
Using HTTP Methods for RESTful Service http://www.restapitutorial.com/lessons/httpmethods.html
Resource Naming http://www.restapitutorial.com/lessons/restfulresourcenaming.html
Idempotence http://www.restapitutorial.com/lessons/idempotency.html
HTTP status code http://www.restapitutorial.com/httpstatuscodes.html
Security (check OWASP rules related to API development) https://www.owasp.org/index.php/Main_Page
Api signature conventions and envelope
You can find a PDF version in this link