리소스 API의 성숙도를 무엇으로 판단하는가?

리소스를 URI로 나누고 HTTP 메서드와 상태 코드를 의미에 맞게 쓰며 응답이 다음 행동 링크를 제공하는지로 판단한다. 단계가 높을수록 HTTP 의미를 더 사용한다.

Richardson 모델은 API가 HTTP를 얼마나 충실히 사용하는지 설명한다. Level 2만 되어도 자원과 행위, 오류 의미가 명확해져 일반적인 API에 실용적이다.

Level 3의 HATEOAS는 클라이언트가 링크를 따라 상태를 전이하게 한다. 결합을 줄일 수 있지만 링크 규약과 클라이언트 구현 비용이 커진다.

높은 단계가 모든 API의 품질 순위는 아니다. 조직의 클라이언트 통제 범위와 변경 빈도에 비해 복잡성의 이득이 있는지 판단해야 한다.