바이브 코딩 →

HTTP 상태 코드(200·401·404·500)HTTP Status Code

HTTP 상태 코드(HTTP Status Code)는 택배 배송 조회의 상태 표시 같은 것 — 웹 요청을 보냈을 때 서버가 결과를 세 자리 숫자로 알려 주는 약속으로, 200은 성공, 401은 인증 실패, 404는 없음, 500은 서버 오류예요.

HTTP 상태 코드는 택배 배송 조회 화면의 '배송 완료', '주소 불명', '집하 오류' 같은 상태 표시와 비슷해요. 브라우저나 프로그램이 서버에 요청을 보내면, 서버는 결과를 세 자리 숫자로 함께 돌려줘요. 첫 자리로 큰 분류를 알 수 있는데, 2로 시작하면 성공, 3은 다른 곳으로 이동, 4는 요청한 쪽의 문제, 5는 서버 쪽의 문제예요.

강의에서는 두 장면에서 나와요. Supabase 연결 테스트를 했을 때 200이 뜨는 걸 보여 주며, 컴퓨터끼리 약속한 응답 번호이고 '정상 처리됐다'는 뜻이라고 설명해요. 또 임베딩 테스트 함수를 호출했더니 401 에러가 났는데, AI에게 '호출 인증 연결해 줘'라고 하자 해결됐어요. 401은 요청에 인증 정보가 없거나 틀렸을 때 나는 오류라서, API 키나 토큰을 제대로 넣으면 풀려요.

초보가 알아 두면 좋은 건 자주 보는 번호 몇 개예요. 401은 '누구세요?'(인증 필요), 403은 '알지만 권한 없음', 404는 '그런 주소 없음', 429는 '요청이 너무 많음', 500은 '서버 안에서 문제 발생'이에요. 에러가 나면 숫자부터 보고 내 쪽 문제인지 서버 쪽 문제인지 가르면 원인을 훨씬 빨리 찾아요. AI에게 물을 때도 상태 코드와 에러 메시지를 함께 붙여 주세요.

💡 대표 예시

  • 연결 테스트 — Supabase 연결을 시험하고 200이 뜨면 정상으로 본다
  • 401 해결 — 함수 호출에서 401이 나자 AI에게 호출 인증을 연결하게 한다
  • 404 점검 — 주소를 바꾼 뒤 옛 링크가 404를 내는지 확인한다
  • 429 대응 — 요청이 너무 많다는 응답이 오면 호출 간격을 늘린다
  • 500 대응 — 서버 오류가 나면 로그를 열어 에러 메시지를 AI에게 보여 준다

🔗 관련 용어

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.