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

265

15

장

REST API와 JSON

클라이언트 오류

클라이언트의 실수로 일어난 오류이며 보통 유효하지 않은 매개변수를 사용하거나 필요한 매

개변수를 제공하지 않았을 때 일어납니다. 이런 오류에 응답 코드

500

은 적절하지 않습니다.

서버에는 아무 문제도 없으니까요. 모든 것이 정상이며, 단순히 클라이언트가

API

를 정확히

사용하지 않았을 뿐입니다. 이 오류에 대응하는 방법은 다양합니다. 상태 코드

200

으로 응답하

고 바디에 오류 메시지를 첨부하거나, 더 적절한

HTTP

상태 코드로 응답할 수도 있습니다. 필

자는 후자를 추천합니다. 이런 경우 가장 유용한 응답 코드는

404

(찾을 수 없음 ),

400

(잘못된

요청 ),

401

(인증되지 않음)입니다. 또한 응답 바디에는 오류를 자세히 설명하는 내용이 있어

야 합니다. 더 추가하자면 오류 메시지에 관련 문서를 가리키는 링크를 넣을 수도 있습니다. 사

용자가 어떤 리스트를 요청했는데 반환할 것이 없다면 그건 오류가 아닙니다. 그냥 빈 리스트

를 반환하는 것이 맞습니다.

책의 예제에서는

HTTP

응답 코드를 쓰고, 바디에는 오류 메시지를 첨부합니다.

15.4

교차 출처 리소스 공유(

CORS

)

API

를 만들고 있다면 다른 사람이 쓰게 할 목적일 겁니다. 따라서

크로스 사이트

HTTP

요청

이

일어납니다. 크로스 사이트 ...