수동으로 작업을 추가할 때는 경로 및 쿼리 매개변수, 헤더, 요청, 응답을 추가하여 작업 세부 정보를 구성해야 합니다.

API 정의를 가져올 경우, 요구 사항에 따라 작업에 적절한 값이 있는지 확인하고 편집해야 합니다. 이러한 세부 정보는 패키지를 사용할 때 Bot editor 또는 API Task 편집기에 표시됩니다. 작업을 추가하면 작업 구성 페이지가 표시됩니다. 구성 탭은 다양한 구성 설정을 표시하며, 테스트 탭의 경우 작업을 테스트할 수 있게 합니다. 구성 탭에서 다음 설정을 사용할 수 있습니다.

구성 탭의 설정

HTTP 메서드
REST API 서버에 보내야 하는 REST 요청 유형을 지정하십시오. 지원되는 HTTP 메서드는 다음과 같습니다.
  • GET
  • PUT
  • POST
  • DELETE
  • PATCH
주: API 정의를 가져올 때, 커넥터 편집기는 지원되지 않는 메서드가 있는 작업을 무시하고 나머지를 사용자 정의 커넥터에 포함합니다.
엔드포인트
이 작업에 사용하는 엔드포인트 URL을 입력합니다. 패키지 사용자는 이 URL을 볼 수 없습니다. 중괄호 {}를 사용하여 URL의 경로 및 쿼리 매개변수를 묶습니다. 예를 들어 /{version}/product/{productid}?status={productStatus}와 같이 입력합니다.
전체 URL
이 읽기 전용 필드는 패키지를 생성할 때 입력한 기본 URL과 엔드포인트 필드의 엔드포인트 URL을 결합하여 자동으로 생성된 필드를 표시합니다. 패키지 사용자에게는 이 URL이 표시되지 않습니다.
요청 매개변수
요청 매개변수를 사용하면 API 서버의 응답을 식별, 정렬 및 필터링할 수 있습니다. 요청 매개변수 추가 옵션을 사용하여 요청 매개변수를 추가하십시오. 경로 및 쿼리 매개변수를 추가할 수 있습니다. 매개변수가 엔드포인트 URL 경로와 일치하는지 확인합니다. 요청 매개변수를 추가하는 방법에 대한 자세한 내용은 요청 매개변수 항목을 참조하십시오.
요청 헤더
요청 헤더를 사용하면 요청에 추가 정보를 추가할 수 있습니다. 요청 헤더를 Accept, Content-Length, Content-Type, Cookie와 같이 추가할 수 있습니다. 요청 헤더 추가에 대한 자세한 내용은 요청 헤더 항목을 참조하십시오.
요청 본문
요청 본문을 사용하면 샘플 페이로드를 가져와 요청 바디의 구조를 정의할 수 있습니다. 페이로드는 API 서버에서 리소스를 생성, 업데이트 또는 삭제하는 데 필요한 실제 데이터입니다. 작업이 실행되면 요청에는 이 페이로드가 포함됩니다. 요청 본문 추가에 대한 자세한 정보는 요청 바디 항목을 참조하십시오.
이용할 수 있는 옵션은 다음과 같습니다.
  • JSON: 이 옵션을 선택하면 요청 바디 속성을 매핑할 JSON 샘플을 가져올 수 있습니다. 리프 노드가 캡처되어 여기에 속성 목록으로 표시됩니다. JSON은 키-값 쌍 구조로 유연성을 제공합니다. 요청 본문바디의 JSON 옵션에 대한 자세한 내용은 JSON 항목을 참조하십시오.
  • 양식 데이터: 이 옵션을 선택하면 양식 데이터 매개변수를 요청 본문 속성으로 추가할 수 있습니다. 양식 데이터 옵션은 콘텐츠 유형을 지정하여 파일을 REST API 서버에 업로드할 때 유용합니다. 양식 데이터 옵션에 대한 자세한 정보는 양식 데이터 항목을 참조하십시오.
  • 양식 URL로 인코딩된 데이터: 이 옵션을 선택하면 요청 본문 매개변수를 쿼리 유형 요청 매개변수와 유사하게 URL 인코딩된 키-값 쌍 형태로 HTML 양식에 추가할 수 있습니다. 양식 URL 인코딩 데이터 인코딩 데이터에 대한 자세한 내용은 양식 URL로 인코딩된 데이터 항목을 참조하십시오.
응답
응답 옵션을 사용하면 응답에서 샘플 페이로드를 가져오고 Bot editorAPI Task 편집기에 표시할 속성을 선택할 수 있습니다. 응답 매개변수 추가에 대한 자세한 내용은 응답 항목을 참조하십시오.