자주 사용되는 HTTP 상태코드 정리

요즈음 클라우드 환경에서는 웹 또는 앱은 서버(클라우드)와의 HTTP API 를 이용하여 통신하는 것이 대부분 입니다.

HTTP 요청에 대한 결과는 HTTP 응답 상태 코드를 통해 확인할 수 있습니다. HTTP 응답 상태 코드는 3자리의 숫자로 표시되며, HTTP 요청에 대한 성공 여부는 물론이고 HTTP 고유의 처리 정보, 서버의 상태, 에러 발생 상황이나 원인에 대한 정보도 알 수 있게 해줍니다.

번호 대역별로는 

• 100번대가 정보 확인
• 200번대가 통신 성공
• 300번대가 리다이렉트
• 400번대가 클라이언트 오류
• 500번대가 서버 오류

에 해당합니다.

클라우드 서비스의 사양에 따라 응답 상태코드는 달라질 수 있지만 자주 사용되는 HTTP 응답 상태코드는 아래 표와 같습니다.

(자세한 응답 코드는 각 클라우드 서비스의 문서나 API레퍼런스를 확인해보시면 됩니다)

애플리케이션의 특성에 따라 응답 코드 별로 적절한 UI를 제공함으로써 사용성을 더 높일 수 있을 것입니다. 

(표 출처 :  「그림으로 배우는 클라우드 인프라와 API의 구조」 히라야마 쯔요시 지음, 로드북) 

번호 대역	상태코드	이름	의미
200번대 (정상)	200	OK	기존에 있는 URI에 대한 요청이 성공함 주로 GET이 사용됨
	201	Create	신규 URI에 대한 리소스 생성이 성공함 주로 POST 가 사용됨
	202	Accepted	요청은 접수되었으나 리소스 처리는 완료되지 않음
	204	No Contents	요청은 성공했으나 제공할 콘텐츠가 없음
300번대 (리다이렉트)	300	Multiple Choice	요청한 URI 에 대해서 여러개의 리소스가 존재함
	301	Move Permanently	요청한 URI가 새 위치로 옮겨갔음 새 위치는 Location 해더에 명시됨
	304	Not Modified	요청한 URI의 내용이 변경되지 않음
400번대 (클라이언트 측 오류)	400	Bad Request	요청이 정상적이지 않음 API에서 정의되지 않은 요청이 들어옴
	401	Unauthorized	인증오류
	403	Forbidden	접근금지 권한 밖의 접근을 시도함
	404	Not Found	요청한 URI에 해당되는 리소스가 존재하지 않음
	405	Method Not Allowed	메소드 오류 API에서 정의되지 않은 메소드를 호출함
	406	Not Acceptable	처리 불가 Accept 해더에 명시된 타입과 호환되지 않음
	408	Request Timeout	요청 대기 시간 초과
	409	Conflict	모순 리소스 변경 시 정합성이 맞지 않음
	429	Too Many Request	요청 횟수 상한 초과
500번대 (서버 측 오류)	500	Internal Server Error	서버(클라우드) 내부 오류 클라우드 측의 로직에 문제가 있음
	502	Bad Gateway	게이트웨이 오류
	503	Service Unavailable	서비스 이용 불가 일시적으로 클라우드 측에 과부하가 걸리거나 다운됨
	504	Gateway Timeout	게이트웨이 시간 초과