Restful api?

Restful API는 REST의 법칙 (Representational State Transfer)의 원칙을 준수한 API 설계라는 의미이다. 즉 method로 방법을 나타내고 endpoint로 리소스를 나타내야 한다.

즉 REST 하다는 것은 메소드와 엔드포인트 만으로도 어떤식으로 api가 동작을 하는 지를 한번에 이해할 수 있도록 설계를 한다는 뜻이다.

그렇다면 아래의 예시의 엔드포인트는 REST 한 API 의 주소인가?

/api/getMovies
/api/deleteMovies
/api/findMoviesByThisYear

위의 엔드포인트는 좋은 API 주소가 아니다. method로 동작을 의미하고 엔드포인트로는 리소스를 나타내야 하는데 위의 엔드포인트는 어떤 곳에서는 get을 find를 사용하고 있으며 쓸데없이 api의 숫자를 늘리고 있다. 즉 RESTful api 로 바꾼다면 다음과 같이 바꾸는 것이 훨씬 좋을 것 같다

/api/movies
method: get
/api/movies
method: delete
/api/movies?year=2023

위의 방식대로 작성하게 되는 것이 바로 RESTful 하다고 할 수 있다.