I’d highly recommend reading Roy Fielding’s dissertation paper where he introduced REST.
For anyone who hasn’t read it, it will fundamentally change how you think about REST and APIs for network services, and you’ll create much better APIs armed with that deeper understanding.
Paper: https://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm
Chapter introducing REST: https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arc...