20

HTTP 메서드와 상태 코드

Day 2: API 문서 읽기

학습 목표

HTTP 메서드(GET, POST, PUT, DELETE)를 이해한다 HTTP 상태 코드의 의미를 안다

HTTP 메서드 = 행동

API 호출은 "무엇을" "어디에" 요청하는 것이다. HTTP 메서드는 "무엇을"에 해당한다.

메서드의미예시
GET조회 (Read)GET /users - 사용자 목록 조회
POST생성 (Create)POST /users - 사용자 생성
PUT전체 수정PUT /users/1 - 사용자 정보 전체 교체
PATCH부분 수정PATCH /users/1 - 이메일만 수정
DELETE삭제DELETE /users/1 - 사용자 삭제

HTTP 상태 코드 = 결과

요청 결과는 숫자 코드로 알려준다.

2xx: 성공

코드의미상황
200OK요청 성공
201Created생성 성공 (POST)
204No Content성공, 응답 본문 없음 (DELETE)

4xx: 클라이언트 오류 (내 잘못)

코드의미원인
400Bad Request요청 형식이 잘못됨
401Unauthorized인증 필요 (로그인 안 함)
403Forbidden권한 없음 (로그인은 했는데)
404Not Found리소스 없음
429Too Many Requests요청 너무 많음 (Rate Limit)

5xx: 서버 오류 (서버 잘못)

코드의미원인
500Internal Server Error서버 내부 오류
502Bad Gateway게이트웨이 오류
503Service Unavailable서버 점검 중

실무에서 자주 만나는 에러

401 Unauthorized

에디터 로딩 중...

-> API 키가 없거나 잘못됨. 환경변수 확인.

429 Too Many Requests

에디터 로딩 중...

-> 요청이 너무 많음. 잠시 후 재시도.

404 Not Found

에디터 로딩 중...

-> URL이 잘못됨. 엔드포인트 확인.

이 3가지만 알아도 API 에러의 70%는 해결할 수 있다.