요청 매개변수
- 최종 업데이트2025/03/24
요청 매개변수 섹션을 사용해 경로, 쿼리 등 다양한 매개변수를 요청에 추가할 수 있습니다. 이렇게 추가된 매개변수가 엔드포인트 URL에 사용된 매개변수와 일치하는지 확인하십시오.
작업
다음과 같은 요청 매개변수 작업이 활성화됩니다.
- 추가
- 요청에 매개변수를 추가하려면
- 편집
- 요청에서 사용 가능한 기존 매개변수를 편집하려면
- 삭제
- 요청에서 사용 가능한 매개변수를 삭제하려면
매개변수 테이블
테이블에서 다음 매개변수 세부 정보를 확인할 수 있습니다.
| 열 | 설명 |
|---|---|
| 유형 | 매개변수의 유형을 표시합니다. 매개변수는 쿼리 매개변수이거나 경로 매개변수일 수 있습니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 매개변수 유형을 볼 수 없습니다. |
| 키 | 매개변수 키를 표시합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 키를 볼 수 없습니다. 키는 헤더의 일부로 전송됩니다. |
| 값 | 매개변수 값을 표시합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 이 값을 확인하고 업데이트할 수 있습니다. |
| 값은 사용자가 제공합니다. | 값의 상태를 표시합니다.
|
| 라벨 | 사용자가 제공한 값에 대한 매개변수 레이블을 표시합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 매개변수 라벨을 볼 수 있습니다. |
| 설명 | 매개변수 설명을 표시합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 매개변수 설명을 볼 수 있습니다. |
요청 매개변수 추가
- 매개변수 요청 탭을 클릭합니다.
- 테이블 상단의 매개변수 추가 버튼 또는 더하기 아이콘(+)을 클릭하여 매개변수를 추가합니다.
-
매개변수 추가 모달에서 다음 작업을 수행하세요.
-
매개변수 유형: 다음 중 하나를 선택합니다.
- 쿼리: 이러한 매개변수는 URL 경로에서 ? 뒤에 추가됩니다. 예: /accounts?user_account=company.
- 경로: 이러한 매개변수는 URL 경로에 바로 추가됩니다. 예: /accounts/{user_account}.
- 키: 적절한 키 이름을 입력합니다. 키 이름은 Bot 편집기 또는 API 태스크 편집기에서 패키지 사용자에게 표시되지 않습니다. 이 이름은 헤더의 일부로 전송됩니다.
-
값 설정 섹션에서 다음 옵션 중 하나를 선택합니다.
유형 설명 하드 코딩 매개변수에 대해 하드 코딩된 값을 입력합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 이 값을 볼 수 없습니다. 이 값은 헤더의 일부로 전송됩니다. 사용자 제공 - 값 입력 유형: 이 입력 값 유형을 보호하려면 이 확인란을 활성화합니다. 보안 옵션을 선택하면 자격증명, 변수 또는 안전하지 않은 문자열을 통해 매개변수를 입력할 수 있습니다.
- 이 필드는 필수입니까? 매개변수의 요구 사항에 따라 아니요 또는 예를 선택합니다.
- 값: 값을 입력합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 이 값을 확인하고 업데이트할 수 있습니다.
- 라벨: 매개변수에 대한 레이블을 입력합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 매개변수 라벨을 볼 수 있습니다.
- 설명: 매개변수에 대한 설명을 입력합니다. 패키지 사용자는 Bot 편집기 또는 API 태스크 편집기에서 매개변수 설명을 볼 수 있습니다. 설명은 편집기에서 도움말 텍스트로 표시됩니다.
-
매개변수 유형: 다음 중 하나를 선택합니다.
-
추가를 클릭하여 요청에 매개변수를 추가합니다.
새 매개변수가 매개변수 테이블에 표시되며, 테이블 제목의 매개변수 개수가 자동으로 업데이트됩니다.