HTTP 리소스

HTTP 리소스 생성

목 서버에 새로운 HTTP 리소스를 생성할 수 있습니다.

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

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

    figure mock more menu icon active
  3. image 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 이때 [HTTP 리소스 생성] 메뉴를 선택합니다.

  4. [new Mock Resource] 탭 화면이 열리면 HTTP 리소스의 정보를 설정합니다. (*: 필수 항목)

    figure mock request create
    • 기본 정보

      항목 설명

      목 파일 이름 *

      HTTP 리소스의 이름입니다.

      전송 방식 & URL *

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

      설명

      HTTP 리소스에 대한 간략한 설명입니다.

    • 응답

      항목 설명

      응답 유형 이름 *

      응답 유형의 이름입니다. 기본적으로 '기본 응답’이 제공되고, 새로운 응답 유형을 추가할 수 있습니다.

      자세한 내용은 응답 유형 관리를 참고합니다.

      기본 응답 설정 *

      기본 응답으로 사용할지 여부입니다. 기본 응답으로 설정된 응답 유형은 조건을 만족하지 않는 모든 요청에 대해 자동으로 반환됩니다.

      • image: 사용함

      • image: 사용 안 함

      기본 응답은 하나만 지정할 수 있으며, 다른 응답 유형이 기본 응답으로 지정되면 기존의 기본 응답은 자동으로 해제됩니다.

      응답 코드 *

      응답 시 반환할 HTTP 상태 코드입니다.

      [조건]

      응답 반환 조건을 설정합니다. 조건이 충족된 경우에만 해당 응답이 반환됩니다.
      ※ '기본 응답’으로 지정된 응답 유형은 조건을 설정할 수 없습니다.

      자세한 내용은 응답 조건 설정을 참고합니다.

      [헤더]

      응답에 포함할 헤더 정보를 설정합니다.

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

      [바디]

      응답에 포함할 메시지 본문을 설정합니다.

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

  5. 설정이 완료되면 화면 오른쪽 상단의 [저장] 버튼을 클릭합니다.

응답 유형 관리

응답 유형 생성

새로운 응답 유형을 생성할 수 있습니다.

[HTTP 리소스] 탭 화면의 '응답' 영역에서 [+ 응답 유형 추가] 버튼을 클릭하면 새 응답 유형이 추가됩니다.

figure mock request response add

응답 유형 이름 변경

응답 유형의 이름을 변경하여 식별하기 쉽게 설정할 수 있습니다.

  1. [HTTP 리소스] 탭 화면의 '응답' 영역에서 이름을 변경할 응답 유형을 선택합니다.

    figure mock request response edit button
  2. '응답 유형 이름' 입력란에 새로운 이름을 입력합니다.

    figure mock request response name edit

응답 유형 삭제

사용하지 않는 응답 유형을 삭제할 수 있습니다. 단, '기본 응답’으로 지정된 응답 유형은 삭제할 수 없습니다.

  1. [HTTP 리소스] 탭 화면의 '응답' 영역에서 삭제할 응답 유형에 마우스를 올린 후 image 아이콘을 클릭합니다.

    figure mock request response del
  2. 응답 유형 삭제 대화상자가 열리면 [삭제] 버튼을 클릭합니다.

응답 조건 설정

특정 조건이 충족될 경우에만 해당 응답이 반환되도록 조건을 설정할 수 있습니다. 단, '기본 응답’으로 지정된 응답 유형은 조건 설정이 불가능합니다.

  1. [HTTP 리소스] 탭 화면의 '응답' 영역에서 조건을 설정할 응답 유형을 선택합니다.

    figure mock request response type select
  2. [조건] 탭을 클릭한 후 조건을 설정합니다.

    figure mock request response condition set

    이때 조건은 여러 개 추가할 수 있으며, '연산 방식' 항목의 설정에 따라 조건 검증 방식이 달라집니다. AND를 선택하면 모든 조건을 만족해야 응답이 반환되고, OR을 선택하면 조건 중 하나만 만족해도 응답이 반환됩니다.

    • 조건 추가

      [+ 행 추가] 버튼을 클릭하여 새로운 조건을 입력할 수 있는 행을 추가합니다.

      항목 설명

      카테고리

      조건을 검사할 영역입니다.

      • BODY: 목 요청 바디 내 특정 필드값 비교

      • HEADER: 목 요청 헤더 내 특정 속성값 비교

      • QUERY_PARAMETER: 목 요청 쿼리 파라미터값 비교

      필드

      검증할 값을 확인할 대상입니다.

      다음은 카테고리별 입력 예시입니다.

      • BODY: a.b

      • HEADER: Content-Type

      • QUERY_PARAMETER: param1

      조건

      필드에서 추출한 값과 검증값을 비교할 때 사용할 연산자입니다.

      • = (Equal): 검증값과 결과값이 일치하는지 확인

      • != (Not Equal): 검증값과 결과값이 일치하지 않는지 확인

      • () (Contains): 결과값에 검증값이 포함되어 있는지 확인

      • !() (Not Contains): 결과값에 검증값이 포함되어 있지 않은지 확인

      • < (Less Than): 결과값이 검증값보다 작은지 확인

      • <= (Less or Equal): 결과값이 검증값보다 작거나 같은지 확인

      • > (Greater Than): 결과값이 검증값보다 큰지 확인

      • >= (Greater Or Equal): 결과값이 검증값보다 크거나 같은지 확인

      검증값

      필드에서 추출한 값과 비교할 기준값입니다.

    • 조건 삭제

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

헤더 정보 설정

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

figure mock request header set
  • 헤더 추가

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

    항목 설명

    활성화

    헤더의 적용 여부입니다.

    • image: 적용함

    • image: 적용 안 함

    항목

    헤더의 이름입니다.

    헤더에 설정할 값입니다.

    설명

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

  • 헤더 삭제

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

전송 메시지 설정

[바디] 탭에서는 요청 또는 응답에 포함할 메시지 본문을 설정할 수 있습니다. 이때 입력 방식으로 에디터 모드를 지원하며, 코드 블록에 요청 또는 응답 데이터를 직접 입력합니다.

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

figure http resource body set

HTTP 리소스 삭제

사용하지 않는 HTTP 리소스를 삭제할 수 있습니다.

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

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

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

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