How to (and how not to) design REST APIs

 Designing REST APIs using best practices can improve their usability. This guide goes over multiple tips and examples of how to do so, such as using plural nouns for collections in URLs, avoiding unnecessary path segments, and refraining from adding extensions like ".json" to URLs. It also recommends not returning arrays as top-level responses, avoiding map structures in JSON responses, using strings for all identifiers, and more.

click here