🔙뒤로가기

REST API는 클라이언트와 서버 간의 자원에 대한 상호작용을 가능하게 하는 인터페이스이다.

1. 자원(Resource) REST API에서 자원은 서버에서 관리되는 데이터 객체나 서비스 기능을 나타낸다. 자원은 URI(Uniform Resource Identifier)를 통해 고유하게 식별된다.
2. URI(Uniform Resource Identifier) 자원을 고유하게 식별하고 접근하는 데 사용되는 문자열. REST API에서는 자원에 대한 액세스와 조작을 위해 URI를 사용하며, URI 서계 원칙에 따라 직관적이고 일관된 구조를 가져야 한다.
3. HTTP 메소드 자원에 대한 동작을 정의하는 데 사용되는 표준 HTTP 동작이다. 주요 HTTP 메소드로는 GET(조회), POST(생성), PUT(전체 수정), PATCH(부분 수정), DELETE(삭제) 등이 있다.
4. 표현(Representation) 클라이언트와 서버가 자원에 대한 상태를 교환하는 데 사용되는 데이터 포맷. 일반적으로 JSON, XML 등의 형식 사용
5. 상태 코드(HTTP Status Codes) 서버는 클라이언트에게 요청 처리 결과를 알리기 위해 HTTP 상태 코드를 사용한다. 상태 코드는 세 자리 숫자로 구성되며, 200(성공), 201(생성됨), 400(잘못된 요청), 404(찾을 수 없음) 등이 있다.
6. 인증 및 권한 관리 API 사용에 대한 보안을 위해 인증 및 권한 관리 기능이 필요하다. OAuth, JWT(JSON Web Token) 등의 기술을 사용하여 사용자 인증 및 권한을 관리할 수 있다.

이외에도 캐싱, 버전 관리, HATEOAS(Hypertext As The Engine Of Application State), API 문서화 등과 같은 다양한 요소들이 REST API의 완성도를 높이는 데 기여할 수 있다. 이러한 구성 요소를 적절하게 활용하면, REST API는 사용하기 쉬우면서도 유연하고 확장 가능한 웹 서비스를 구현할 수 있다.