API 요청 정의 자동 생성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 23일
  • 소요 시간: 2분

    • API 자원에 대한 샘플 요청을 사용하여 해당 자원에 대한 요청 헤더 연결, 쿼리 매개변수 연결 및 요청 스키마를 생성합니다.

    시작하기 전에

    인스턴스 관리자는 이 시스템 속성을 glide.rest.sampling.enabled true로 설정해야 합니다. 성능 문제의 가능성을 제한하려면 비프로덕션 인스턴스에서만 API 요청 정의의 자동 생성을 활성화하십시오.

    필요한 역할: web_service_admin

    프로시저

    1. 다음 방법 중 하나로 스크립팅된 REST API 요청 샘플링 구성을 만듭니다.
      옵션절차
      스크립팅된 REST API 기록을 통해 탐색
      1. 다음으로 이동 모두 > 시스템 웹 서비스 > 스크립트 기반 REST 서비스 > 스크립트 기반 REST API.
      2. 스크립팅된 REST API 기록을 선택합니다.
      3. 자원 관련 목록에서 자원을 선택합니다.
      4. 샘플 링 요청 구성 탭에서 새로 만들기를 선택합니다.
      스크립트된 새 REST API 요청 샘플링 구성으로 직접 이동
      1. 다음으로 이동 모두 > 시스템 웹 서비스 > 스크립트 기반 웹 서비스 > 스크립팅된 REST 샘플링 구성.
      2. 새로 만들기를 선택합니다.
      3. REST 자원 필드에서 요청 정의를 자동으로 생성할 스크립팅된 REST 자원을 선택하거나 입력합니다.
    2. 최대 샘플 필드에 자동 정의 생성을 위해 분석할 샘플 요청 수를 입력합니다.
      1에서 1000 사이의 숫자를 입력해야 합니다.
    3. 제출을 선택합니다.

      자원에 대한 요청은 5단계에서 설정한 샘플 수까지 분석을 위해 샘플링됩니다. 최대 샘플 수에 도달하면 요청 샘플링 구성 상태가 분석됨 으로 설정되고 REST 요청 스테이징 스키마를 검토할 수 있습니다.

      요청 샘플링 구성 기록에서 샘플 링 완료를 선택하여 최대 샘플 수에 도달하기 전에 샘플링을 종료할 수 있습니다.

    4. 샘플링이 끝나면 스크립팅된 REST 자원의 요청 샘플링 구성 탭에서 해당 번호를 선택하여 생성한 요청 샘플링 구성으로 돌아갑니다.
    5. REST 요청 준비 스키마 목록에서 기록을 선택하여 헤더, 본문 및 쿼리 매개변수 필드에서 자동으로 생성된 요청 정의를 검토하고 편집합니다.
      본문 구조는 HTTP POST 메서드에 대해 PUT 서만 생성됩니다.
    6. 스크립트된 REST API 자원 및 연결된 스크립트된 REST API 서비스에 정의를 추가하려면 커밋 을 선택합니다.

    결과

    • 커밋된 REST 요청 스테이징 스키마와 샘플 요청이 삭제됩니다.
    • 헤더 필드 내용은 자원의 요청 헤더 연결을 만드는 데 사용됩니다. 연결된 요청 헤더가 관련 REST 서비스의 요청 헤더 탭에 추가됩니다.
    • 본문 필드 컨텐츠는 자원의 요청 스키마를 만드는 데 사용됩니다. 자원의 요청 스키마가 관련 REST 서비스의 스키마 탭에 추가됩니다.
    • 쿼리 매개변수 필드 내용은 자원의 쿼리 매개변수 연결을 만드는 데 사용됩니다. 연결된 쿼리 매개변수가 관련 REST 서비스의 쿼리 매개변수 탭에 추가됩니다.
    • 추가한 모든 커밋된 요청 정의는 REST API 탐색기의 익스포트 가능한 OpenAPI 사양에 포함됩니다. OpenAPI 사양 익스포트에 대한 자세한 내용은 다음 문서를 참조하십시오 OpenAPI 사양으로 익스포트.