웹훅으로 외부 시스템 호출하기

Data Connection의 웹훅(Webhook)은 Foundry에서 외부 시스템으로 보내는 요청을 구성합니다. 사용자가 애플리케이션의 버튼을 눌렀을 때 외부 API에 레코드를 생성하거나 기존 업무 절차를 실행하는 방식으로 사용할 수 있습니다. 외부 시스템이 Foundry로 보내는 웹훅을 받으려면 Listener를 사용합니다.

소스와 웹훅의 역할

웹훅 하나는 Data Connection 소스 하나에 연결됩니다. 소스는 외부 시스템의 주소, 네트워크 경로와 인증 정보를 보관합니다. 웹훅은 그 연결을 사용해 실행할 요청과 입력 및 출력 매개변수를 정의합니다. 사용할 수 있는 요청 유형은 소스 종류에 따라 달라집니다.

REST API 소스에서는 HTTP 메서드, 상대 경로, 쿼리 매개변수, 헤더와 본문을 구성합니다. 입력 매개변수를 요청에 넣고 외부 응답에서 필요한 값을 추출하여, 다음 요청이나 액션의 객체 편집에 전달할 수 있습니다. 실행 시간, 동시 실행 수와 기간별 실행 횟수도 제한할 수 있습니다.

구성과 사용 경로

• 웹훅 생성에서는 소스와 요청을 만들고, 기존 웹훅 복제 및 cURL 가져오기를 설명합니다.
• 설정 참조에는 입력 자료형, 응답 추출, 실행 제한, 권한과 이력 보관, OAuth 흐름이 있습니다.
• Microsoft Graph 연동은 토큰 발급과 메일 API 호출을 하나의 웹훅으로 연결합니다.
• 함수에서 웹훅 사용은 사전 정의된 요청을 함수의 전처리, 후처리와 결합하는 절차를 설명합니다.

최종 사용자 애플리케이션에서는 웹훅을 액션에 연결할 수 있습니다. 액션 입력을 웹훅 입력에 매핑하고, 응답에서 추출한 외부 레코드 ID 같은 값을 온톨로지 편집에 사용합니다. 웹훅 자체를 온톨로지 함수로 게시하면 Workshop, OSDK, 다른 함수와 함수 기반 액션에서도 재사용할 수 있습니다. 함수 게시를 활성화하는 작업은 되돌릴 수 없고 게시된 함수도 삭제할 수 없으므로, 게시 조건을 먼저 확인합니다.