HTTP 요청 보내기

첫 요청을 보내는 데 약 10초 걸립니다. 이 가이드는 기본 사항을 안내하며 일상적인 API 테스트에 필요한 모든 것을 다룹니다.

첫 요청

1. HTTP 패널 열기 — Mac에서 Cmd+H 또는 Windows/Linux에서 Ctrl+H를 누르거나 왼쪽 스트립에서 HTTP 아이콘을 클릭합니다.
2. URL 입력 또는 붙여넣기 — 상단 주소 표시줄에. 예: https://jsonplaceholder.typicode.com/posts/1
3. 메서드 선택 — 메서드 드롭다운이 기본적으로 GET으로 설정됩니다. 클릭하여 POST, PUT, DELETE, PATCH, HEAD 또는 OPTIONS로 전환합니다.
4. Send 클릭 — 파란색 Send 버튼이 요청을 보냅니다.
5. 응답 읽기 — 응답 패널이 아래에 상태 코드, 헤더, 본문과 함께 표시됩니다.

그게 전부입니다. 프로젝트 설정 없음, 구성 파일 없음, 계정 필요 없음.

요청 헤더 추가

대부분의 API는 인증, 콘텐츠 유형 또는 버전 관리를 위한 헤더를 필요로 합니다. 추가 방법:

1. Headers 탭을 클릭합니다 (Params 및 Body 옆)
2. + Add Header를 클릭합니다
3. 왼쪽 필드에 헤더 이름을, 오른쪽 필드에 값을 입력합니다
4. 헤더는 제거할 때까지 모든 요청과 함께 자동으로 전송됩니다

가장 일반적으로 사용하는 헤더:

필요한 만큼 헤더를 추가할 수 있습니다. 헤더 옆의 체크박스를 체크 해제하여 삭제하지 않고 일시적으로 비활성화합니다.

요청 본문 추가

POST, PUT, PATCH 요청에는 일반적으로 데이터와 함께 본문을 보냅니다. 방법:

1. Body 탭을 클릭합니다
2. 형식 드롭다운에서 JSON을 선택합니다 (또는 API에 따라 Form, Text, Binary)
3. JSON 페이로드를 입력하거나 붙여넣습니다

새 게시물 생성을 위한 예시 JSON 본문:

{
  "title": "My New Post",
  "body": "This is the content of the post.",
  "userId": 1
}

에디터는 입력하면서 JSON을 검증하고 구문 오류를 밑줄로 표시합니다. 보내기 전에 수정하세요 — 잘못된 본문은 일반적으로 400 Bad Request를 발생시킵니다.

응답 검사

요청이 완료되면 응답 패널에 필요한 모든 것이 표시됩니다:

• 상태 코드 — 상단에 두드러지게 표시됩니다. 2xx 성공은 초록색, 3xx 리디렉션은 노란색, 4xx 클라이언트 오류 및 5xx 서버 오류는 빨간색.
• 응답 시간 — 요청이 걸린 시간(밀리초). 느린 엔드포인트를 발견하는 데 유용합니다.
• 응답 크기 — 응답 본문의 크기.
• 본문 — 응답이 JSON인 경우 자동으로 예쁘게 인쇄됩니다. 트리 뷰를 사용하여 중첩 객체를 접고 펼칩니다.
• 헤더 — 응답 패널의 Headers 탭을 클릭하여 서버가 보낸 모든 헤더를 확인합니다.

유효한 JSON과 함께 200 OK가 표시되면 엔드포인트가 작동 중입니다. 401 Unauthorized는 일반적으로 인증 헤더가 잘못되었음을 의미합니다. 404 Not Found는 URL 경로가 잘못되었음을 의미합니다.

요청 저장

요청이 작동하면 URL과 헤더를 다시 입력하지 않도록 저장합니다:

1. Save 버튼을 클릭합니다 (플로피 디스크 아이콘 또는 Cmd+S를 누름)
2. 요청에 설명적인 이름을 지정합니다 — "Get user by ID" 또는 "Create product" 등
3. 저장할 컬렉션을 선택하거나 생성합니다
4. Save를 클릭합니다

저장된 요청이 왼쪽 사이드바의 컬렉션 아래에 표시됩니다. 저장한 그대로 URL, 메서드, 헤더, 본문을 다시 로드하려면 언제든지 클릭합니다. 컬렉션은 세션 간에 유지되므로 요청은 돌아올 때 항상 있습니다.