통합 - Amazon Quick
AWS 서비스외부 애플리케이션REST API 통합

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

통합

AWS 서비스

Amazon S3

Amazon S3 작업을 사용하면 파일과 데이터를 저장하고 검색할 수 있습니다.

사용 가능한 작업

  • 파일 다운로드 - Amazon S3에서 파일을 다운로드하고 파일 객체 핸들을 반환합니다.

  • 파일 업로드 - Amazon S3에 파일 객체 핸들을 업로드합니다.

  • 객체 복사 - 소스 파일 하나에서 대상 위치로 Amazon S3에 이미 저장된 객체의 복사본을 생성합니다.

  • 객체 삭제 - S3 버킷에서 지정된 객체를 삭제합니다.

  • 객체 나열 - 지정된 버킷의 모든 객체를 나열합니다. 접두사를 사용하여 필터링할 수 있습니다.

Amazon Bedrock

Amazon Bedrock 작업을 사용하면 단일 API를 통해 주요 AI 회사의 파운데이션 모델(FMs)에 연결할 수 있습니다.

  • 기본 모델 대화 - AI 모델에 프롬프트를 보냅니다. 자연어를 사용하여 텍스트를 생성하고, 콘텐츠를 분석하고, AI 기반 응답을 받을 수 있습니다.

  • 고급 모델 대화 - 더 많은 옵션이 있는 모델을 프롬프트합니다. 고급 옵션에는 사용자 지정 메시지 형식, 도구 통합, 모델 동작에 대한 세분화된 제어가 포함됩니다.

Amazon Bedrock 에이전트

Amazon Bedrock Agent 작업을 사용하면 데이터 소스, APIs 및 백엔드 시스템에 연결할 수 있는 AI 어시스턴트를 호출할 수 있습니다.

  • 기본 에이전트 호출 - AI 에이전트에 요청을 보냅니다. 파일 첨부 파일, 사용자 입력 또는 사용자 지정 구성이 필요하지 않은 간단한 상호 작용에 사용합니다.

  • 고급 에이전트 호출 - 더 많은 옵션을 사용하여 에이전트를 호출합니다. 파일 첨부 파일, 사용자 입력 또는 사용자 지정 구성이 필요한 고급 상호 작용에 사용됩니다.

Amazon Bedrock 데이터 자동화

Bedrock Data Automation(BDA)은 생성형 AI를 사용하여 비정형 콘텐츠에서 중요한 인사이트를 추출하는 프로세스를 간소화합니다.

사용 가능한 작업

  • 데이터 자동화 비동기 호출 - 데이터 자동화 프로젝트 또는 블루프린트로 데이터를 처리합니다. 비동기 데이터 처리를 시작하고 호출 ID를 반환합니다.

  • 데이터 자동화 상태 가져오기 - 데이터 자동화 호출 상태 및 출력 위치에 대한 세부 정보를 가져옵니다.

Amazon Textract

Amazon Textract를 사용하면 자동화에 문서 텍스트 감지 및 분석을 추가할 수 있습니다.

  • 기본 문서 쿼리 - 질문을 기반으로 데이터를 추출합니다. 각 쿼리에는 요청하려는 질문과 연결하려는 별칭이 포함됩니다. Textract는 각 질문에 대한 텍스트 답변과 신뢰도 점수를 제공합니다.

  • 기본 문서 분석 - 문서에서 데이터를 추출합니다. 문서 레이아웃 및 데이터 관계를 유지하면서 양식(키-값 페어), 테이블(정형 데이터) 및 텍스트를 자동으로 감지하고 추출합니다.

Amazon Comprehend

Amazon Comprehend는 문서 콘텐츠에 대한 인사이트를 얻기 위한 자연어 처리(NLP) 서비스입니다. 텍스트를 분석하여 주요 구문을 추출하고, 감정을 식별하고, 문서를 분류하는 데 도움이 됩니다.

사용 가능한 작업

  • 문서 분류 - 사용자 지정 모델 엔드포인트를 사용하여 단일 문서를 실시간으로 분석하는 분류 요청을 생성합니다. 텍스트 입력 또는 문서 파일(PDF, Word 또는 이미지)을 지원합니다.

  • 키 문구 감지 - 텍스트에 있는 주요 명사 문구를 감지하여 콘텐츠 내의 중요한 개념과 주제를 식별합니다.

외부 애플리케이션

Microsoft Outlook

Microsoft Outlook 작업을 통해 자동화를 통해 이메일과 일정을 관리할 수 있습니다.

  • 이메일

    • 사용자 이메일 전송 - 특정 사용자를 대신하여 이메일 메시지를 전송합니다.

    • 이메일 회신 - 메시지 발신자에게 회신합니다.

    • 폴더 메시지 나열 - 로그인한 사용자 사서함의 특정 폴더에 있는 메시지를 가져옵니다.

    • 사용자 메일 나열 - 로그인한 사용자의 사서함(삭제된 항목 및 Clutter 폴더 포함)에서 메시지를 가져옵니다.

    • 이메일 보기 - 특정 메시지 객체의 속성 및 관계를 검색합니다.

    • 이메일 업데이트 - 메시지 객체의 속성을 업데이트합니다.

    • 이메일 삭제 - 지정된 사용자의 사서함에서 메시지를 삭제합니다.

    • 이메일 첨부 파일 나열 - 메시지에 연결된 첨부 파일 객체 목록을 검색합니다.

    • 첨부 파일 가져오기 - 첨부 파일의 속성, 관계 또는 원시 콘텐츠를 읽습니다.

  • 폴더

    • 메일 폴더 나열 - 로그인한 사용자의 루트 폴더 바로 아래에 있는 메일 폴더 컬렉션을 가져옵니다.

    • 이메일을 폴더로 이동 - 메시지를 지정된 사용자의 사서함 내의 다른 폴더로 이동합니다.

    • 사서함 설정 가져오기 - 자동 회신, 날짜 형식 및 시간대와 같은 사용자의 사서함 설정을 가져옵니다.

  • 일정

    • 일정 이벤트 나열 - Microsoft Outlook에서 지정된 사용자 또는 리소스에 대한 일정 이벤트 목록을 가져옵니다.

    • 일정 이벤트 생성 - 사용자의 기본 일정 또는 지정된 일정에 이벤트를 생성합니다.

    • 일정 이벤트 업데이트 - 기존 이벤트 객체의 속성을 업데이트합니다.

  • 기타

    • 장소 목록 - 테넌트에 정의된 장소 객체(방 또는 방 목록) 모음을 가져옵니다.

    • 사용자 나열 - Microsoft Outlook에서 기본 정보를 사용하여 조직의 사용자 목록을 검색합니다.

    • 연락처 나열 - 로그인한 사용자의 기본 연락처 폴더에서 연락처 컬렉션을 가져옵니다.

Microsoft Teams

Microsoft Teams 작업을 통해 자동화는 채널 및 채팅 메시지를 통해 팀원과 통신하고 회의를 관리할 수 있습니다.

  • 메시지

    • 채팅 나열 - 모든 채팅 대화 보기

    • 채팅 생성 - 새 채팅 대화 시작

    • 개별 채팅 가져오기 - 특정 채팅의 세부 정보 보기

    • 모든 채팅 메시지 나열 - 채팅 대화에서 메시지 보기

    • 채팅 메시지 전송 - 채팅에서 새 메시지 전송

  • 팀

    • 팀 나열 - 인증된 사용자가 액세스할 수 있는 모든 팀 보기

    • 팀 가져오기 - 특정 팀에 대한 세부 정보 보기

    • 모든 팀원 나열 - 팀원 보기

    • 팀에 사용자 초대 - 팀에 새 멤버 추가

  • 채널

    • 모든 채널 나열 - 특정 팀 내의 모든 채널 보기

    • 채널 생성 - 팀 내에 새 채널 생성

    • 채널 가져오기 - 특정 채널에 대한 세부 정보 보기

    • 모든 채널 메시지 나열 - 채널에 게시된 메시지 보기

    • 채널 메시지 전송 - 채널에 새 메시지 게시

    • 채널 메시지에 회신 - 기존 채널 메시지에 회신 추가

    • 채널 멤버 초대 - 특정 채널에 멤버 추가

  • 회의

    • 온라인 팀 회의 생성 - 새 온라인 회의 예약

    • 온라인 팀 회의 받기 - 특정 회의의 세부 정보 보기

    • 모든 레코딩 나열 - 회의의 레코딩 보기

    • 모든 트랜스크립트 나열 - 회의의 트랜스크립트 보기

  • Users

    • 사용자 목록 - 조직 내 사용자 목록 보기

Microsoft SharePoint

Microsoft SharePoint를 사용하면 자동화를 통해 문서와 정보를 중앙에서 저장, 관리 및 공유할 수 있습니다.

  • 목록 및 항목

    • 목록 가져오기 - 목록과 연결된 작업 목록 가져오기

    • 항목 생성 - 목록에서 새 목록 항목 생성

    • 항목 업데이트 - listItem의 속성 업데이트

    • 항목 삭제 - 목록에서 항목을 제거합니다.

    • 항목 가져오기 - 목록의 항목에 대한 메타데이터를 반환합니다.

    • 항목 나열 - 목록의 항목 모음 가져오기

  • 시트 및 파일

    • 시트 추가 - 통합 문서에 새 워크시트 추가

    • 시트 삭제 - 통합 문서에서 워크시트 제거

    • 시트 업데이트 - 워크시트 속성 편집(이름 변경, 가시성)

    • 목록 시트 - 워크시트 객체 목록 검색

    • 읽기 시트 - 워크시트의 속성 검색

    • 파일 업로드 - 통합 파일 생성 또는 업데이트

  • 범위 및 셀

    • 읽기 범위 - 지정된 범위에서 값을 검색합니다.

    • 범위 삭제 - 지정된 범위의 셀을 삭제합니다.

    • 쓰기 범위 - 지정된 범위의 값을 업데이트합니다.

    • 사용된 범위 가져오기 - 지정된 워크시트의 사용된 범위를 반환합니다.

    • 범위 지우기 - 형식, 채우기 및 테두리를 포함한 범위 값 지우기

    • 셀 읽기 - 특정 셀에서 값을 가져옵니다.

    • 셀 쓰기 - 특정 셀의 값을 설정합니다.

Microsoft OneDrive

Microsoft OneDrive 작업을 사용하면 파일을 저장, 동기화 및 공유할 수 있습니다. 스프레드시트 작업을 위해 OneDrive에 저장된 Microsoft Excel 파일과 직접 상호 작용할 수 있습니다.

  • 파일 관리

    • 항목 가져오기 - 특정 파일 또는 폴더의 세부 정보 보기

    • 드라이브 가져오기 - OneDrive 계정 세부 정보 및 스토리지 정보 보기

    • 항목 나열 - 드라이브의 모든 파일 및 폴더 보기

    • 항목 생성/폴더 생성 - OneDrive에서 새 폴더 또는 항목 생성

    • 하위 항목 나열 - 특정 폴더에 포함된 항목 보기

    • 항목 삭제 - 파일 또는 폴더 제거

    • 항목 업데이트/항목 이동 - 메타데이터 업데이트 또는 폴더 간 파일 이동

    • 항목 복사 - 다른 위치에 파일 또는 폴더의 복사본 생성

    • 권한 추가 - 파일에 대한 공유 및 액세스 권한 구성

    • 파일 업로드 - OneDrive에 새 파일 추가

  • Excel

    • 시트 추가 - Excel 통합 문서에서 새 워크시트 생성

    • 범위 지우기 - 셀 범위에서 콘텐츠 및 형식 제거

    • 범위 삭제 - 워크시트에서 셀, 행 또는 열 제거

    • 시트 삭제 - 통합 문서에서 워크시트 제거

    • 목록 시트 - 통합 문서의 모든 워크시트 보기

    • 셀 읽기 - 특정 셀의 값 가져오기

    • 읽기 범위 - 셀 범위에서 값 가져오기

    • 시트 읽기 - 전체 워크시트의 내용 보기

    • 사용된 범위 읽기 - 데이터가 포함된 셀의 범위 가져오기

    • 시트 업데이트 - 워크시트 속성 수정

    • 셀 쓰기 - 특정 셀의 값 설정

    • 쓰기 범위 - 셀 범위의 값 설정

Salesforce

Salesforce 작업을 사용하면 사례, 기회, 리드, 캠페인, 고객 응대 등에서 고객 관계를 관리하는 프로세스를 자동화할 수 있습니다.

  • 사례

    • 사례 목록 가져오기 - 메타데이터 및 최근 항목을 포함하여 Salesforce에서 고객 지원 사례 목록을 가져옵니다.

    • 사례 가져오기 - 특정 사례의 세부 정보 보기

    • 사례 생성 - 새 지원 사례 생성

    • 사례 삭제 - 기존 사례 제거

    • 사례 업데이트 - 사례 세부 정보 및 정보 편집

  • 기회

    • 기회 얻기 - 판매 기회 목록 보기

    • 특정 기회 얻기 - 특정 기회의 세부 정보 보기

    • 기회 생성 - 새 영업 기회 생성

    • 기회 업데이트 - 기회 세부 정보 편집

    • 기회 삭제 - 기존 기회 제거

  • 리드

    • 리드 업데이트 - 리드 세부 정보 및 정보 편집

  • 캠페인

    • 캠페인 업데이트 - 캠페인 세부 정보 및 정보 편집

  • 피드 항목

    • 피드 항목 업데이트 - 피드 항목 콘텐츠 및 속성 편집

  • 연락처

    • 연락처 목록 가져오기 - 시스템의 모든 연락처 보기

    • 연락처 가져오기 - 특정 연락처의 세부 정보 가져오기

    • 연락처 업데이트 - 연락처 정보 편집

  • Users

    • 사용자 목록 가져오기 - Salesforce 사용자 목록 검색

  • 시스템

    • SObject 설명 - 모든 Salesforce 객체 유형에 대한 객체 메타데이터 및 필드 세부 정보 가져오기

Jira

Jira 작업을 사용하면 문제, 프로젝트, 스프린트 등의 관리를 자동화할 수 있습니다.

  • 문제

    • 문제 생성 - 프로젝트에서 문제를 생성합니다.

    • 문제 편집 - 프로젝트의 기존 문제를 수정합니다.

    • 문제 상태 업데이트(전환 수행) - 문제의 작업 상태를 변경합니다.

    • 문제 삭제 - 프로젝트의 문제를 삭제합니다.

    • 문제 가져오기 - 프로젝트의 문제에 대한 세부 정보를 봅니다.

    • 문제 검색 - JQL을 사용하여 문제를 검색합니다.

    • 검색 상태 - 문제 상태를 검색합니다.

    • 문제 첨부 파일 다운로드 - 첨부 파일의 내용을 봅니다.

    • 첨부 파일 추가 - 문제에 첨부 파일을 추가합니다.

    • 모든 레이블 가져오기 - 모든 레이블을 봅니다.

  • 설명

    • 설명 추가 - 문제에 새 설명을 추가합니다.

    • 설명 삭제 - 문제에서 설명을 제거합니다.

    • 설명 업데이트 - 문제에 대한 기존 설명을 편집합니다.

    • 설명 가져오기 - 문제 설명을 봅니다.

  • Projects

    • 프로젝트 생성 - Jira에서 새 프로젝트를 생성합니다.

    • 프로젝트 업데이트 - 프로젝트 세부 정보를 수정합니다.

    • 프로젝트 삭제 - Jira에서 프로젝트를 제거합니다.

    • 프로젝트 가져오기 - 프로젝트 세부 정보를 봅니다.

    • 프로젝트의 문제 유형 가져오기 - 프로젝트 문제 유형을 봅니다.

    • 프로젝트 검색 - 표시되는 프로젝트를 찾습니다.

  • 스프린트

    • 스프린트 생성 - 프로젝트에 스프린트를 생성합니다.

    • 스프린트 업데이트 - 스프린트 세부 정보를 업데이트합니다.

    • 스프린트 삭제 - 프로젝트에서 스프린트를 삭제합니다.

    • 스프린트 가져오기 - 프로젝트에서 스프린트의 세부 정보를 봅니다.

    • 문제를 스프린트로 이동 및 순위 지정 - 스프린트에 문제를 할당합니다.

    • 문제를 백로그로 이동 - 문제를 백로그로 이동합니다.

  • Users

    • 사용자 찾기 - Jira 사용자를 검색합니다.

    • 할당 가능한 사용자 찾기 - 문제에 할당할 수 있는 사용자 목록을 반환합니다.

    • 모든 사용자 가져오기 - 모든 Jira 사용자를 나열합니다.

ServiceNow

ServiceNow 작업을 사용하면 인시던트, 변경 요청 등의 IT 서비스 관리를 자동화할 수 있습니다.

  • 인시던트

    • 인시던트 생성 - 새 인시던트 레코드를 생성합니다.

    • 인시던트 읽기 - 특정 인시던트의 세부 정보를 검색합니다.

    • 인시던트 업데이트 - 기존 인시던트 레코드를 수정합니다.

    • 인시던트 삭제 - 특정 인시던트 레코드를 제거합니다.

  • 변경 요청

    • 변경 요청 생성 - 새 변경 요청 레코드를 생성합니다.

    • 변경 요청 읽기 - 특정 변경 요청의 세부 정보를 검색합니다.

    • 변경 요청 업데이트 - 기존 변경 요청 레코드를 수정합니다.

    • 변경 요청 삭제 - 특정 변경 요청 레코드를 제거합니다.

  • 지식 기반 문서

    • 지식 기반 문서 업데이트 - 기존 지식 기반 문서를 수정합니다.

  • 문제 레코드

    • 문제 레코드 업데이트 - 기존 문제 레코드를 수정합니다.

  • 첨부 파일

    • 이진 첨부 파일 업로드 - 파일을 지정된 레코드에 첨부 파일로 업로드합니다.

    • 멀티파트 양식 첨부 파일 업로드 - 레코드에 양식 첨부 파일을 업로드합니다.

    • 첨부 파일 콘텐츠 검색 - 특정 첨부 파일의 이진 콘텐츠를 가져옵니다.

    • 첨부 파일 메타데이터 검색 - 특정 첨부 파일에 대한 메타데이터를 가져옵니다.

    • 첨부 파일 삭제 - 시스템에서 첨부 파일을 제거합니다.

    • 첨부 파일에 대한 메타데이터 검색 - 여러 첨부 파일에 대한 메타데이터를 가져옵니다.

  • 시스템

    • 사용자 나열 - 시스템 사용자 테이블에서 모든 기존 레코드를 검색합니다.

    • 목록 선택 - 시스템에서 선택 목록 값을 검색합니다.

SAP

SAP 작업을 통해 비즈니스 파트너 데이터, 재료 재고, 재료표, 제품 마스터 및 물리적 인벤토리와 관련된 프로세스를 자동화할 수 있습니다.

  • SAP 비즈니스 파트너

    • 비즈니스 파트너 가져오기 - 비즈니스 파트너의 일반 데이터를 검색하여 파트너 정보에 대한 포괄적인 보기를 제공합니다.

    • ID로 비즈니스 파트너 가져오기 - 특정 비즈니스 파트너 번호를 식별자로 사용하여 자세한 비즈니스 파트너 데이터를 검색합니다.

    • 비즈니스 파트너 주소 가져오기 - 우편 주소 및 연락처 정보를 포함하여 비즈니스 파트너와 관련된 주소 세부 정보를 검색합니다.

    • 비즈니스 파트너 역할 가져오기 - 비즈니스 파트너의 역할 정보를 검색하여 시스템 내 관계와 기능을 보여줍니다.

    • ID로 비즈니스 파트너 역할 가져오기 - 키 식별자 필드를 사용하여 비즈니스 파트너의 특정 역할 데이터를 검색합니다.

  • SAP 재료 재고

    • 계정 모델 컬렉션에서 재료 재고 가져오기 - 배치, 스토리지 위치 및 특수 재고 지표와 같은 세부 정보가 포함된 재료 재고 수준을 가져옵니다.

  • SAP 자재 명세서

    • 자재 BOM 항목 가져오기 - 수량, 범주 및 관계를 포함하여 자재 청구서에 사용되는 자재의 세부 정보를 검색합니다.

  • SAP 제품 마스터

    • 제품 마스터 레코드 가져오기 - 제품 마스터 일반 세부 정보를 봅니다. 특정 데이터를 필터링, 정렬 및 선택하는 옵션이 포함된 전체 제품 마스터 레코드를 반환합니다.

    • 제품 마스터 레코드의 공장 데이터 가져오기 - 제품의 공장 세부 정보를 봅니다. 제조, 스토리지 및 물류 데이터를 포함하여 특정 제품에 대한 자세한 공장별 정보에 액세스합니다.

    • 제품 번호 및 공장별로 공급 계획 데이터 가져오기 - 제품 번호 및 공장별로 공급 계획 세부 정보를 봅니다. 로트 크기, 안전 재고 수준 및 조달 데이터를 포함한 세부 계획 파라미터를 검색합니다.

  • SAP 물리적 인벤토리

    • Phys 인벤토리 문서 항목 가져오기 - 결과 및 인벤토리 차이 계산을 포함한 물리적 인벤토리 문서 항목을 검색합니다.

REST API 통합

REST API 연결 통합을 통해 Quick Automate는 사용자 지정 REST APIs 및 웹 서비스와 상호 작용하여 외부 시스템으로 자동화 기능을 확장할 수 있습니다. 이 통합은 GET, POST, DELETE, PATCH 및 PUT HTTP 메서드에 대한 작업 실행을 지원합니다.

일반적인 사용 사례:

  • 외부 시스템에 알림 전송

  • 타사 서비스에서 데이터 검색

  • 외부 데이터베이스의 레코드 업데이트

  • 연결된 애플리케이션에서 워크플로 트리거

사전 조건

REST API 통합으로 자동화를 생성하기 전에 다음을 갖추어야 합니다.

  • 구성된 REST API 통합

    • Quick Suite 콘솔 액세스

    • 통합 > REST API 연결로 이동합니다.

    • 기본 URL을 사용하여 REST API 엔드포인트 구성

    • 인증 설정 완료(아래 인증 섹션 참조)

    • 전체 세부 정보: REST API 연결 통합

  • 자동화 그룹에 연결된 통합

    • 구성된 REST API 통합을 자동화 그룹에 연결

    • 사용 가능한 작업에 통합이 나타나는지 확인

    • Step-by-step 가이드: AWS 서비스 작업 커넥터

  • 인증 구성됨

    • API 공급자로부터 얻은 OAuth 2.0 자격 증명

Authentication

Quick Automate의 경우이 통합은 OAuth 2.0 인증을 지원합니다. 자동화를 생성하기 전에 OAuth 자격 증명을 구성해야 합니다.

OAuth 2.0 설정 단계:

  • 자격 증명 공급자로부터 OAuth 자격 증명(클라이언트 ID 및 클라이언트 보안 암호) 획득

  • Quick Suite 콘솔에서 REST API 통합 설정으로 이동합니다.

  • 인증 방법으로 OAuth 2.0 선택

  • 클라이언트 ID와 클라이언트 보안 암호를 입력합니다.

  • API 공급자가 제공하는 권한 부여 URL 및 토큰 URL 구성

  • OAuth 흐름을 완료하여 Quick Suite에 권한 부여

  • 연결을 테스트하여 인증 확인

중요 참고 사항:

  • Quick Automate는 요청 헤더에서 보유자 토큰 인증을 지원하지 않습니다. 대신 OAuth 구성을 사용합니다.

  • 자동화 작업이 아닌 통합 수준에서 인증 구성

구성

REST API 통합 설정

1단계: 기본 URL 구성 생성

2단계: 자동화 그룹에 연결

3단계: REST API 작업 액세스

  • 자동화에서 작업 패널 열기

  • REST API 작업 찾기

  • 작업을 자동화 워크플로로 끌어서 놓기

  • 참고

    REST API 작업은 작업 패널을 통해 추가해야 하며, Build with Assistant 인터페이스에서는 사용할 수 없습니다.

속성 참조

  • Q 작업 커넥터 ID(필수)

    • 설명: 기본 URL 및 인증 설정을 포함하여 REST API 작업을 구성된 통합에 연결하는 고유 식별자입니다.

    • 형식: 연결된 통합에서 자동으로 채워짐

    • 예: rest-api-connector-abc123

  • URI(선택 사항)

    • 설명: 정확한 API 엔드포인트를 지정하기 위해 기본 URL에 추가 경로가 추가되었습니다.

    • 형식: 선행 슬래시가 있거나 없는 경로 문자열(기본 URL 형식에 따라 다름)

    • 작동 방식:

      • 기본 URL: https://api.example.com

      • URI: /users/123

      • 최종 URL: https://api.example.com/users/123

    • 예:

      /users/123
prod/send-email
/v2/orders
customers/search

  • 추가 헤더(선택 사항)

    • 설명: API 요청에 키-값 페어로 포함할 사용자 지정 HTTP 헤더입니다.

    • 형식:

      Key: Value

    • 일반적인 예:

      Content-Type: application/json
Accept: application/json
X-Custom-Header: custom-value
X-API-Version: 2.0

    • 중요 제한 사항:

      • 권한 부여 헤더를 포함하지 마십시오. 인증은 OAuth 구성을 통해 처리됩니다.

      • 각 헤더는 별도의 줄에 있어야 합니다.

      • 헤더는 대/소문자를 구분합니다.

  • 요청(필수)

    • 설명: POST 또는 PUT 요청과 함께 전송할 JSON 형식의 데이터입니다.

    • 형식: 유효한 JSON 객체입니다. 빈 요청의 경우 {}

    • POST 요청 예제(리소스 생성):

      {
  "title": "My New Post",
  "body": "This is the content of my new post.",
  "userId": 1,
  "tags": ["automation", "api"],
  "published": true
}

    • PUT 요청 예제(리소스 업데이트):

      {
  "status": "completed",
  "completedDate": "2026-01-27",
  "notes": "Task finished successfully"
}

  • 출력 변수(선택 사항)

    • 설명: 후속 자동화 작업에 사용할 API 호출의 JSON 응답을 저장하는 변수 이름입니다.

    • 형식: 영숫자 변수 이름(공백 없음)

    • 예: apiResponse, userData, orderDetails

API 사용 예

예제 1: GET 요청 - 티켓 세부 정보 검색

시나리오: 외부 티켓팅 시스템에서 기존 지원 티켓의 세부 정보 검색

구성:

  • Q Action Connector ID: rest-api-connector-tickets

  • HTTP 메서드: GET

  • URI: /tickets/ticketId

  • 추가 헤더:

    Accept: application/json

  • 요청 본문: {}( GET 요청의 경우 비어 있음)

  • 출력 변수: ticketDetails

예제 2: POST 요청 - 새 레코드 생성

시나리오: 외부 티켓팅 시스템에 새 지원 티켓 제출

구성:

  • Q Action Connector ID: rest-api-connector-tickets

  • HTTP 메서드: POST

  • URI: /tickets

  • 추가 헤더:

    Content-Type: application/json
Accept: application/json

  • 요청 본문:

    {
  "title": "{{ticketTitle}}",
  "description": "{{ticketDescription}}",
  "priority": "{{ticketPriority}}",
  "requestedBy": "{{userEmail}}",
  "category": "technical_support"
}

  • 출력 변수: ticketResponse