API
글 7개
API · Versioning
버저닝과 하위 호환
v2를 냈는데 v1을 못 내리는 상황을 어떻게 피하나. 깨지 않고 바꾸는 방법이 먼저이고, 버전을 가르는 건 그다음이다.
·API 설계 7편
API · GraphQL
GraphQL - 필요한 것만 받는다
화면 하나에 API를 다섯 번 부르는 문제를 GraphQL은 어떻게 다르게 푸나. REST와의 차이와 그 대가만 본다.
·API 설계 6편
API · JSON
JSON - 왜 이게 표준이 됐나
타입이 여섯 개뿐인 형식이 어떻게 API의 기본이 됐나. 큰 정수·날짜·null이라는 세 함정과 스키마 없음의 대가.
·API 설계 5편
API · REST
상태 코드와 에러 응답
200 OK인데 본문에 error가 있는 응답은 왜 문제인가. 상태 코드를 고르는 기준과 에러 본문을 한 벌로 통일하는 법.
·API 설계 4편
API · REST
Endpoint 설계
같은 목록을 주는 URL이 여럿이 되지 않게 하는 법. 컬렉션과 단건, 중첩 기준, 필터·정렬·페이징 파라미터와 목록 응답 모양을 정한다.
·API 설계 3편
API · REST
REST - 자원으로 말한다
/getUserList는 왜 REST가 아닌가. 동사를 URL에서 걷어내고 자원과 메서드로 말하는 방식을 잡는다.
·API 설계 2편
API · Design
API는 약속이다
내부 코드는 언제든 고치지만 공개한 API는 남이 이미 그 모양에 맞춰 코드를 짜뒀다. API를 계약으로 보는 관점을 잡는다.
·API 설계 1편