API 개발하기(4) - API 엔드포인트 아키텍처 패턴

RESTful HTP API

- 리소스를  URL로 표현하고 해당 리소스에 행하고자 하는 의도를 HTTP 메소드로 정의하는 방식

- 각 엔드포인트는 처리하는 리소스를 표현하는 고유의 URI 주소를 가지고 있음

- ex) 사용자 정보를 리턴하는 "/users"라는 엔드포인트에서 사용자 정보를 받아오는 HTTP 요청

HTTP GET /users
GET /users

- ex) 새로운 사용자를 생성하는 엔드포인트는 URI를 "/user"로 정하고 요청을 표현

POST /user
{
	"name" : "현욱"
    "email" : "lego7407@naver.com"
}

---

GraphQL

- 특정 클라이언트에 맞춰져 다른 클라인언트에서 사용하기 적합하지 않음

- 엔드포인트가 오직 하나

- 엔드포인트에 클라이언트가 피룡한 것을 정의해서 요청하는 식

- ex) HTTP 요청

#일반1
GET /users/1
GET /users/1/friends

#일반2
GET /users/1?include=friends.name

#GraphQL
POST /graphql
{
	user(id: 1){
    	name
        age
        friends {
        	name
            ...
        }
    }
}