Restful API
- 클라이언트와 서버 간 통신 규칙과 규약 제공
- 강제성이 없고, 이미 컨벤션이 있다면 존중하라
REST는 웹 기반 애플리케이션에서 자원을 표현하고 상태를 전송하기 위한 아키텍처 스타일입니다.
이는 RESTful API의 규칙과 규약을 제공하며, 이를 통해 클라이언트와 서버 간의 통신이 이루어집니다.
자원은 고유한 URI(Uniform Resource Identifier)로 표현되고, HTTP 메서드를 사용하여 자원을 조작합니다.
Restful API 예시
-
모든 사용자 조회:
GET: /users
-
특정 사용자 조회:
GET: /users/{id}
-
새로운 사용자 생성:
POST: /users
-
특정 사용자 수정:
PUT: /users/{id}
-
특정 사용자 삭제:
DELETE: /users/{id}
주의사항
RESTful API는 이해하기 쉬운 주소를 설계하는 데 도움이 되며, 협업 시 모호함을 줄여줍니다. 그러나 강제성이 있는 인터페이스(강제 규약)는 아닙니다.
가장 중요한 것은 동료들과 작업하기 좋은 주소를 설계하는 것입니다.
여기서 동료는 프론트엔드 개발자, 백엔드 개발자를 의미하며, 일반 사용자를 의미하지 않습니다. 이는 일반 사용자에게 저 주소는 아무런 의미가 없기 때문입니다.
이미 동료들과 합의한 규칙 즉 컨벤션이 있다면, 그 규칙을 따르는 것이 일반적입니다.
레퍼런스
- Understanding And Using REST APIs — Smashing Magazine
부족한 점이나 잘못 된 점을 알려주시면 시정하겠습니다 :>
728x90
'DEV > Backend' 카테고리의 다른 글
Hibernate (0) | 2023.07.11 |
---|---|
MyBatis (0) | 2023.07.11 |
Mock API 작성하는 팁 (0) | 2023.07.10 |
TypeORM의 Entity 참조는 어떻게 일어나는가? (0) | 2023.06.27 |
조회 vs Join 무엇이 더 효율적인가 (0) | 2023.06.27 |