더 나은 나를 위한 노력

REST, REST API, RESTful

|

REST

  • Representational State Transfer
  • 웹의 모든 자원(이미지, 동영상, DB 자원)에 고유한 URI를 부여해 활용하기 위하여, 자원을 정의하고 자원에 대한 주소를 지정하는 방법론
  • REST = 자원(URI) + 행위(HTTP method) + 표현(representations)
    • URI : 모든 자원에 고유한 ID인 HTTP URI를 부여
    • HTTP method: POST(생성), GET(조회), PUT(수정), DELETE(삭제), HEAD(헤더 정보 조회)와 같은 HTTP 프로토콜의 method 사용
    • Representation : client가 자원에 대해 요청하면, Sever는 자원을 JSON, XML, TEXT, RSS 등 여러 형태로 응답

REST, RESTful

  • REST API : REST를 기반으로 구현한 서비스 API (=RESTful API)
  • RESTful : “REST API”를 제공하는 웹 서비스

RESTful API를 위한 URI 설계 시 주의사항

  • 슬래시 구분자(/)는 계층 관계를 나타내므로 URI 마지막 문제로 미포함
  • 하이픈(-)은 가독성을 위하여 사용
  • 밑줄(_)은 URK에 사용하지 않음
  • 다른 리소스로 인식되는 문제를 피하기 위하여 주로 숫자만 사용
  • 확장자는 URI에 미포함