HTTP 요청

HTTP 요청 생성

새로운 HTTP 요청을 생성할 수 있습니다.

  1. 워크스페이스 화면에서 [Request] 메뉴를 선택합니다.

  2. 리소스 영역의 목록에서 특정 컬렉션(또는 폴더)에 마우스를 올리면 오른쪽 끝에 image 아이콘이 표시됩니다.

    figure more menu icon active

  3. image 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 이때 [HTTP 요청 생성] 메뉴를 선택합니다.

  4. [New Request] 탭 화면이 열리면 HTTP 요청의 정보를 설정합니다. (*: 필수 항목)

    figure http request create
    항목 설명

    요청 이름 *

    요청의 이름입니다.

    전송 방식 & URL *

    API 호출 방식(GET, POST, PUT, DELETE)과 요청을 보낼 URL입니다.

    설명

    요청에 대한 간략한 설명입니다.

    [파라미터] 탭

    요청에 사용할 쿼리 파라미터를 설정합니다.

    자세한 내용은 쿼리 파리미터 설정을 참고합니다.

    [헤더] 탭

    요청에 포함할 헤더 정보를 설정합니다.

    자세한 내용은 헤더 정보 설정을 참고합니다.

    [바디] 탭

    요청에 포함할 메시지 본문을 설정합니다.
    ※ 전송 방식이 'GET’인 경우에는 설정할 수 없습니다.

    자세한 내용은 전송 메시지 설정을 참고합니다.

    [응답] 탭

    요청의 연결 방식을 설정합니다.

    자세한 내용은 연결 정보 설정을 참고합니다.

  5. 설정이 완료되면 [저장] 버튼을 클릭합니다.

쿼리 파리미터 설정

[파라미터] 탭에서는 요청에 사용할 쿼리 파라미터를 추가하거나 삭제할 수 있습니다.

figure request params set

  • 파라미터 추가

    [+ 행 추가] 버튼을 클릭하여 새로운 쿼리 파라미터를 입력할 수 있는 행을 추가합니다.

    항목 설명

    항목

    파라미터의 이름입니다.

    값

    파라미터에 설정할 값입니다.

  • 파라미터 삭제

    삭제할 파라미터의 체크박스를 선택한 후 [행 삭제] 버튼을 클릭하거나, 각 행의 image 아이콘을 클릭합니다.

헤더 정보 설정

[헤더] 탭에서는 요청에 포함할 헤더 정보를 추가하거나 삭제할 수 있습니다.

figure request header set

  • 헤더 추가

    [+ 행 추가] 버튼을 클릭하여 새로운 헤더 정보를 입력할 수 있는 행을 추가합니다.

    항목 설명

    활성화

    헤더의 적용 여부입니다.

    • image: 적용함

    • image: 적용 안 함

    항목

    헤더의 이름입니다.

    값

    헤더에 설정할 값입니다.

    설명

    헤더에 대한 간략한 설명입니다.

  • 헤더 삭제

    삭제할 헤더의 체크박스를 선택한 후 [행 삭제] 버튼을 클릭하거나, 각 행의 image 아이콘을 클릭합니다.

전송 메시지 설정

[바디] 탭에서는 요청에 포함할 메시지 본문을 설정할 수 있습니다.

figure request body set

지원하는 데이터 입력 방식은 다음과 같습니다.

입력 방식 설명

None

요청 본문을 입력하지 않습니다.

Raw

요청 본문을 직접 입력합니다.

  • TEXT: 문자열을 그대로 입력 (에디터 모드 지원)

  • JSON: JSON 형식으로 입력 (에디터, 테이블 모드 지원)

  • XML: XML 형식으로 입력(에디터 모드 지원)

에디터 모드

코드 블록에 요청 데이터를 직접 입력합니다.

JSON 또는 XML 형식에서는 코드 블럭 오른쪽 상단의 image 버튼을 클릭하면 데이터가 자동으로 정렬되어 보기 쉽게 표시됩니다.

figure request body set editor

테이블 모드

표 형태로 요청 데이터를 구성합니다.

figure request body set table

  • 데이터 추가

    [+ 행 추가] 버튼을 클릭하여 새로운 요청 데이터를 입력할 수 있는 행을 추가합니다.

    항목 설명

    필드

    데이터의 필드 이름입니다.

    타입

    데이터의 타입입니다.

    • String

    • Number

    • Boolean

    • Object

    • Array

    값

    필드에 입력할 실제 값입니다.

  • 데이터 삭제

    삭제할 요청 데이터의 체크박스를 선택한 후 [행 삭제] 버튼을 클릭하거나, 각 행의 image 아이콘을 클릭합니다.

연결 정보 설정

[연결] 탭에서는 요청의 연결 방식을 설정할 수 있습니다.

figure request connection set
항목 설명

인코딩

서버와 데이터를 주고받을 때 사용하는 문자 인코딩 방식입니다.

요청 타임아웃

서버에 요청을 보내고 응답이 시작되기까지 기다리는 최대 시간입니다. 시간이 초과하면 요청이 실패합니다. (단위: 밀리초)

응답 타임아웃

서버가 응답을 완료할 때까지 기다리는 최대 시간입니다. 시간이 초과하면 연결이 종료됩니다. (단위: 밀리초)

HTTP 요청 삭제

사용하지 않는 HTTP 요청을 삭제할 수 있습니다.

  1. 워크스페이스 화면에서 [Request] 메뉴를 선택합니다.

  2. 리소스 영역의 목록에서 HTTP 요청에 마우스를 올리면 오른쪽 끝에 image 아이콘이 표시됩니다.

    figure request more menu icon active

  3. image 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 이때 [리소스 삭제] 메뉴를 선택합니다.

  4. 리소스 삭제 대화상자가 열리면 [삭제] 버튼을 클릭합니다.