한 권으로 끝내는 Node & Express: 웹사이트 구축을 위한 서버 사이드 자바스크립트

235

15

장

-

REST API와 JSON

| 클라이언트 에러 |

클라이언트 에러는 클라이언트 쪽 실수의 결과이며 보통 매개변수가 없거나 잘못됐을 때 생깁

니다. 응답 코드

500

은 적절하지 않습니다. 서버 문제는 아니니까요. 모든 것이 정상이며 클

라이언트에서

API

를 정확하게 사용하지 않고 있는 겁니다. 옵션은 두 가지입니다. 상태 코드

200

으로 응답하면서 응답 본문에서 에러에 대해 설명하거나, 혹은 적절한

HTTP

상태 코드

로 에러임을 나타낼 수 있습니다. 필자는 후자를 권합니다. 이런 경우 가장 유용한 응답 코드는

404

(찾을 수 없음),

400

(잘못된 요청),

401

(권한 없음)입니다. 또한, 응답 본문에도 에러에

관한 설명을 넣어야 합니다. 한 걸음 더 나아가서 에러 메시지에 문서 링크를 넣을 수도 있습니

다. 사용자가 어떤 목록을 요청했는데 반환할 것이 없는 상황은 에러가 아닙니다. 그냥 빈 목록

을 반환하면 됩니다.

우리 애플리케이션에서는

HTTP

응답 코드와 본문의 에러 메시지를 조합해 쓸 겁니다. 이 방

법은 제이쿼리와 호환되는데, 현재

API

에 접근할 때 제이쿼리를 이용하는 경우가 대부분이므

로 이는 중요한 고려 사항입니다.

15.4.

크로스 소스 자원 공유(

CORS

)

API

를 만들고 있다면 다른 사람이 그

API

를 쓰게 하고 싶을 겁니다