RESTful API의 기본 개념, 구성

API (Application Programming Interface)

  • 응용 프로그램에서 사용 할 수 있도록 운영체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스
  • API를 통해 소스 및 DB에는 접근하지 못하게 하고 해당 프로그램을 사용할 수 있도록 기능을 제공하게 하는 것

RestFul API

REST(Representational State Transfer)

  • 서버나 서비스에 존재하는 모든 자원(이미지, 동영상, DB)에 고유한 URI를 부여해 활용하는 것
  • 자원을 정의하고 자원에 대한 주소를 지정하는 방법론

통신을 위한 REST 구성

  • 자원(Resource) : http://service.com/users라는 는 형태의 URI
  • 행위(Method) : GET/POST/DELETE/PUT과 같은 메소드
  • 표현(Message) : JSON, XML 등의 형태를 이용해 표현


URI(URL)

  • 구성


HTTP Methods / Message Format


HTTP Methods

  • GET : 데이터 호출
  • POST : 데이터 생성
  • PUT : 데이터 업데이트, 모든 속성을 확인하여 값을 수정
  • PATCH : 데이터 업데이트, 일부 속성에 대한 값을 수정
  • DELETE : 데이터 삭제

Message Format

JSON으로 메시지 주고받기

1. 배열은 [ ] 중괄호를 사용

2. 객체는 { } 대괄호로 정의 (딕셔너리 형태)

3. 변수와 값은 쌍으로 존재,  " names : values "

4. 문자열은 큰 따옴표 안에 사용, 작은 따옴표는 인식 X

ret = { 'count' : 2 ,
        'students' : [ { 'name' : '홍길동', 'age' : 38 } ,
                       { 'name' : '김나나', 'age' : 25 } ]
      }