It is everything you need to know and thinks about the angle of the people who need to consume your API. Quick read too.
https://www.amazon.com/REST-API-Design-Handbook-ebook/dp/B00...