Rest API란 !

박성현·2024년 11월 12일

java

목록 보기
48/51

🌐 REST API 기본 개념

REST란 무엇인가요? 🤔

REST(Representational State Transfer)클라이언트와 서버 간의 데이터를 전송하는 방식 으로, 주로 HTTP 프로토콜을 사용 합니다. REST API는 URL을 통해 자원에 접근하고, HTTP 메서드를 통해 해당 자원에 대한 작업을 수행합니다.

간단히 말하면 : REST는 서버에 상태를 저장하지 않고(stateless), 요청마다 독립적으로 처리되는 리소스 기반 접근 방식입니다.

🚀 HTTP 메서드

REST에서 자주 사용하는 HTTP 메서드는 다음과 같습니다:

  • GET: 자원 조회
    (예: 사용자 목록 보기)
  • POST: 자원 생성
    (예: 새로운 사용자 추가)
  • PUT: 자원 수정
    (예: 기존 사용자 정보 수정)
  • DELETE: 자원 삭제
    (예: 특정 사용자 삭제)

📍 상태 코드

HTTP 응답에 반환되는 상태 코드는 요청 처리 결과를 알려줍니다. 예를 들어:

  • 200 OK: 요청 성공 ✅
  • 201 Created: 자원 생성 성공 🎉
  • 400 Bad Request: 잘못된 요청 ❌
  • 404 Not Found: 자원 미발견 😞
  • 500 Internal Server Error: 서버 오류 😱

🌍 RESTful URL 설계

RESTful APIURL을 자원을 나타내는 방식으로 설계합니다. 예를 들어:

  • GET /users : 모든 사용자 목록 조회
  • GET /users/{id} : 특정 사용자 조회
    중요 : URL은 간결하고 명확해야 합니다. 자원에 대한 이름은 명사로 작성하세요!

REST와 다른 API 스타일의 차이점 🤖

REST는 간단하고 직관적이며, SOAPXML 기반의 복잡한 메시징을 사용하고, GraphQL클라이언트가 필요한 데이터만 요청할 수 있는 쿼리 언어입니다.

👍 장점과 단점

장점:

  • HTTP를 기반으로 하여 간단하고 범용적입니다.

  • 독립적으로 동작하여 확장성과 유연성이 좋습니다.
    단점:

  • 상태 관리가 어렵고, 고급 기능 구현을 위해서는 추가 설계가 필요합니다.

🔐 API 보안

REST API의 보안도 중요한 요소입니다. 인증(Authentication)인가(Authorization) 를 통해 사용자 접근을 제어합니다. 보통 JWT (JSON Web Token) 또는 OAuth 방식이 사용됩니다.

profile
개발기록장

0개의 댓글