rest를 잘 준수하면 그게 restful -
rest란 서버와 클라이언트 사이의 소통 방식 중 하나로 자원을 이름으로 구분하여 자원의 상태를 주고받음
자원을 표현할 때 URI(uniform resoruce identifiers)라는 것으로 표현하는데 ,주소창에 tistory.com/manage - 이런게 URI임
REST에서 자원을 잘 처리하고 관리하기 위해서 쓰는걸로 이거를 잘 네이밍하는게 중요함
ex)서버에서 뭔가를 관리하거나,수정하는 역할을 할 때는 /manage라던가 , /edit 같이 표현하게 되면 API과 직관적이고
의미를 파악하기가 쉬움
URI 네이밍 규칙 -
- 명사 사용하기 - 예외적으로 컨트롤 URI에는 동사 사용 가능하긴함
- 자원 간 계층 관계 표현할 때 / 사용 ex)/comments/3 - 댓글중에 3번댓글
- 하이픈 사용하기
- _ 는 사용하지 말기
- 소문자만 사용
- CRUD 이름 사용하지 말기 - create/comments /getInfo 이런거 안됨
- 새로운 API 만들지 말고 쿼리스트링 사용하기 ex)https://www.youtube.com/watch?v=xWA1eTPSzDE
클라이언트에서 HTTP methods를 보내면 서버에서는 http status code를 보내줌
ex)만약 서버에서 유저 댓글을 얻어오고 싶다면 ? /getComments (x) /comments로 get 요청보내기
유저 댓글을 추가하고 싶다면 ? /postComments (x) /comments로 post 요청보내기
이렇게 같은 URI를 사용하면서 다른 동작이 가능함