Web- RESTful API (2)

RESTful API란?

• 사전적인 의미로는 REST라는 아키텍처를 그대로 적용해서 구현한 웹 서비스를 나타내기 위해 사용되는 용어이다.
• 쉽게 생각해서 REST API를 제공하는 웹 서비스를 RESTful 하다고 생각하면 된다.
• RESTful은 누가 공식적으로 발표한 것이 아니라 REST 구조가 있는 시스템을 RESTful 이라고 한다.

 

RESTful API의 목표

• 이해하기 쉽고 사용하기 용이한 REST API를 만드는 것
• 요청을 보내는 주소만으로도 대략적으로 어떠한 것을 요청하는지 알 수 있어야 한다.
• RESTful API를 구현하는 근본적인 목표는 성능 향상이 아니라 API에 대한 가독성, 이해도를 높여주는 것이기 때문에 성능이 중요시 되는 서비스 경우에는 굳이 RESTful API를 구현할 필요는 없다.

 

 

URI & URL은 무엇이 다를까?

• URI는 Uniform Resource Identifier로 인터넷 상의 자원을 식별하기 위한 문자열의 구성이다.
• URL은 Uniform Resource Locator로 인터넷 상 자원의 위치를 의미한다. 우리가 흔히 사용하는 링크가 URL이다.

 

REST API 응답 코드

1. 100 시리즈 (일시적인 응답)
2. 200 시리즈 (일반적인 성공 응답)
   • 200 - 클라이언트 요청을 서버가 정상적으로 처리완료
   • 201 - 요청을 정상 처리 & 새로운 리소스 생성
   • 202 - 요청은 정상적이나 서버가 아직 요청을 완료 하지 못함
   • 204 - 요청은 정상적이나 컨텐츠를 제공하지 않는다.
3. 300 시리즈 (대부분 URL 리디렉션 용)
4. 400 시리즈 (일반적인 오류 응답)
   • 400 - 잘못된 요청
   • 401 - 클라이언트가 권한이 없어서 더 이상 작업 진행 불가
   • 404 - 요청한 자원이 존재하지 않음
   • 405 - 요청이 허용되지 않은 메소드
   • 409 - 요청이 서버와 충돌이 발생한 경우
5. 500 시리즈 (서버에 관련된 오류)