20분
HTTP 메서드와 상태 코드
Day 2: API 문서 읽기
HTTP 메서드와 상태 코드
영어 문서 독해: API 문서, GitHub, Stack Overflow > 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: 성공
| 코드 | 의미 | 상황 |
|---|---|---|
| 200 | OK | 요청 성공 |
| 201 | Created | 생성 성공 (POST) |
| 204 | No Content | 성공, 응답 본문 없음 (DELETE) |
4xx: 클라이언트 오류 (내 잘못)
| 코드 | 의미 | 원인 |
|---|---|---|
| 400 | Bad Request | 요청 형식이 잘못됨 |
| 401 | Unauthorized | 인증 필요 (로그인 안 함) |
| 403 | Forbidden | 권한 없음 (로그인은 했는데) |
| 404 | Not Found | 리소스 없음 |
| 429 | Too Many Requests | 요청 너무 많음 (Rate Limit) |
5xx: 서버 오류 (서버 잘못)
| 코드 | 의미 | 원인 |
|---|---|---|
| 500 | Internal Server Error | 서버 내부 오류 |
| 502 | Bad Gateway | 게이트웨이 오류 |
| 503 | Service Unavailable | 서버 점검 중 |
실무에서 자주 만나는 에러
401 Unauthorized
에디터 로딩 중...
-> API 키가 없거나 잘못됨. 환경변수 확인.
429 Too Many Requests
에디터 로딩 중...
-> 요청이 너무 많음. 잠시 후 재시도.
404 Not Found
에디터 로딩 중...
-> URL이 잘못됨. 엔드포인트 확인.
이 3가지만 알아도 API 에러의 70%는 해결할 수 있다.