한 권으로 끝내는 Node & Express(2판): 모던 웹을 위한 서버 사이드 자바스크립트의 모든 것

264

한 권으로 끝내는 Node & Express

사유 같은 긴 데이터는 요청 바디로 보내길 권합니다.

TIP

JSON

API

에는 널리 알려지고 많은 사람들이 따르는 표기법이 있습니다. 이름도 창의적인

JSON

:

API

입니

다. 개인적으로 장황하고 반복적이라고 생각하지만, 불완전하더라도 표준이 있는 편이 아예 없는 것보다 낫습

니다. 이 책에서

JSON

:

API

를 따르지는 않지만,

JSON

:

API

에도 적용되는 내용은 모두 설명할 겁니다. 더

많은 정보는

JSON

:

API

홈페이지

3

에서 확인하세요.

15.3

API

오류 보고

HTTP

API

의 오류는 보통

HTTP

상태 코드로 보고합니다. 요청이

200

(

OK

)을 반환하면 클

라이언트는 요청이 성공적으로 수행됐다고 판단합니다. 요청이

500

(내부 서버 오류 )을 반환

한다면 요청은 실패한 겁니다. 하지만 대부분의 애플리케이션에서 모든 것을 ‘성공’과 ‘실패’로

간단히 나눌 수는 없고, 나눠서도 안 됩니다. 예를 들어

ID

를 통해 무언가를 요청했는데 그런

ID

가 존재하지 않는다면 어떨까요? 서버 오류는 아닙니다. 클라이언트에서 존재하지 않는 것

을 요청한 겁니다. 일반적으로 오류는 다음과 같은 그룹으로 묶을 수 있습니다.

심각한 오류

서버를 불안정, 또는 정의되지 않은 상태로 만드는 오류입니다. 보통은 처리하지 않은 예외 ...