REST development

Introduction

REST development best practices

References

How to Design a REST API

https://restfulapi.net/rest-api-design-tutorial-with-example/

Using HTTP Methods for RESTful Services

https://www.restapitutorial.com/lessons/httpmethods.html

REST Resource Naming Guide

https://restfulapi.net/resource-naming+/

Best practices

• Use nouns instead of verbs in endpoints (eg: /v1/curriculums)

• Name collections with plural nouns (eg: applications)

• Use logical nesting on endpoints to show relationships (eg: applications/learning-objects)

• Use filtering (eg: @RequestParam)

• Use sorting and pagination (eg: org.springframework.data.domain.Pageable)

• Be clear with versioning