커넥터 편집기에서 작업 구성
- 최종 업데이트2025/09/10
수동으로 작업을 추가할 때는 경로 및 쿼리 매개변수, 헤더, 요청, 응답을 추가하여 작업 세부 정보를 구성해야 합니다.
API 정의를 가져올 경우, 요구 사항에 따라 작업에 적절한 값이 있는지 확인하고 편집해야 합니다. 이러한 세부 정보는 패키지를 사용할 때 Bot editor 또는 API Task 편집기에 표시됩니다. 작업을 추가하면 작업 구성 페이지가 표시됩니다. 구성 탭은 다양한 구성 설정을 표시하며, 테스트 탭의 경우 작업을 테스트할 수 있게 합니다. 구성 탭에서 다음 설정을 사용할 수 있습니다.
구성 탭의 설정
- HTTP 메서드
- REST API 서버에 보내야 하는 REST 요청 유형을 지정하십시오. 지원되는 HTTP 메서드는 다음과 같습니다.
- GET
- PUT
- POST
- DELETE
- PATCH
- 엔드포인트
- 이 작업에 사용하는 엔드포인트 URL을 입력합니다. 패키지 사용자는 이 URL을 볼 수 없습니다. 중괄호 {}를 사용하여 URL의 경로 및 쿼리 매개변수를 묶습니다. 예를 들어 /{version}/product/{productid}?status={productStatus}와 같이 입력합니다.
- 전체 URL
- 이 읽기 전용 필드는 패키지를 생성할 때 입력한 기본 URL과 엔드포인트 필드의 엔드포인트 URL을 결합하여 자동으로 생성된 필드를 표시합니다. 패키지 사용자에게는 이 URL이 표시되지 않습니다.
- 요청 매개변수
- 요청 매개변수를 사용하면 API 서버의 응답을 식별, 정렬 및 필터링할 수 있습니다. 요청 매개변수 추가 옵션을 사용하여 요청 매개변수를 추가하십시오. 경로 및 쿼리 매개변수를 추가할 수 있습니다. 매개변수가 엔드포인트 URL 경로와 일치하는지 확인합니다. 요청 매개변수를 추가하는 방법에 대한 자세한 내용은 요청 매개변수 항목을 참조하십시오.
- 요청 헤더
- 요청 헤더를 사용하면 요청에 추가 정보를 추가할 수 있습니다. 요청 헤더를 Accept, Content-Length, Content-Type, Cookie와 같이 추가할 수 있습니다. 요청 헤더 추가에 대한 자세한 내용은 요청 헤더 항목을 참조하십시오.
- 요청 본문
- 요청 본문을 사용하면 샘플 페이로드를 가져와 요청 바디의 구조를 정의할 수 있습니다. 페이로드는 API 서버에서 리소스를 생성, 업데이트 또는 삭제하는 데 필요한 실제 데이터입니다. 작업이 실행되면 요청에는 이 페이로드가 포함됩니다. 요청 본문 추가에 대한 자세한 정보는 요청 바디 항목을 참조하십시오.
- 응답
- 응답 옵션을 사용하면 응답에서 샘플 페이로드를 가져오고 Bot editor 및 API Task 편집기에 표시할 속성을 선택할 수 있습니다. 응답 매개변수 추가에 대한 자세한 내용은 응답 항목을 참조하십시오.