웹후크는 웹 응용프로그램 또는 서비스가 거의 실시간으로 다른 웹 서비스에 정보를 전송하도록 만드는 방법입니다. 통신은 사용자가 정의한 특정 이벤트에 의해 트리거됩니다. 시스템은 업데이트를 반복적으로 확인하기보다는 트리거 이벤트가 발생할 때 즉시 알림을 보냅니다.
ArcGIS Online에서는 호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블의 웹후크를 생성할 수 있습니다. 이러한 웹후크는 정의된 이벤트 트리거를 기반으로 웹후크 수신기에 페이로드를 전송합니다. 수신기는 편집 내용을 받으면 미리 정의된 수신자 목록에 알리거나, 편집 내용에 대한 정보를 외부 앱에 내보내 변경 사항 보고서를 생성하거나, 편집된 데이터에 품질관리 스크립트를 실행하는 등 자동화된 작업을 수행하도록 구성됩니다.
이 통신 채널의 컴포넌트는 다음과 같습니다.
- 이벤트 트리거 — 각 이벤트 트리거는 항목의 원본 피처 서비스에서 웹후크를 호출하는 API 작업을 지정합니다. 사용자가 이벤트 트리거로 지정된 작업을 수행하면 웹후크는 해당 정보(페이로드)를 웹후크 수신기에 전달합니다. 웹후크를 생성할 때 트리거를 지정합니다. 설정할 수 있는 특정 이벤트 트리거는 피처 레이어 이벤트 트리거를 참고하세요.
- 페이로드 — 페이로드는 트리거 이벤트에 적합한 정보를 포함합니다. 페이로드에 포함되는 항목에 대한 자세한 내용은 피처 레이어 웹후크 페이로드를 참고하세요.
- 웹후크 수신기 — 웹후크 수신기는 페이로드를 수신하고 미리 정의된 수신자 목록(사용자 또는 앱)에 정보를 전송합니다. 예를 들어, 사용자에게 트리거 이벤트 발생을 알리는 이메일 또는 문자 메시지를 전송하거나, 외부 데이터베이스에 보관할 트리거 이벤트 정보를 전송하거나, 발생한 트리거 이벤트를 기반으로 데이터에 스크립트를 실행할 수 있습니다.
웹후크 수신기로 서드 파티 웹 서비스 수신기 또는 사용자 설정 웹 서비스를 사용할 수 있습니다. 웹후크 수신기는 페이로드를 수신할 수 있도록 HTTPS 연결을 통해 통신하도록 구성되어야 하며, 항목에 웹후크를 추가하기 전에 ArcGIS Online 기관에서 수신기에 접근할 수 있어야 합니다. 웹후크 수신기에는 웹후크를 생성할 때 지정한 페이로드 URL을 통해 접근합니다.
웹후크 수신기는 ArcGIS Online 외부에서 구성됩니다. 수신기를 구성한 후에 웹후크를 생성할 수 있습니다.
요구사항
호스팅 피처 레이어, 뷰, 테이블의 웹후크를 생성하려면 먼저 해당 항목이 다음 요구사항을 충족해야 합니다.
- 데이터의 변경 사항 추적(피처 추가, 업데이트, 삭제)이 활성화되어 있어야 합니다.
- 항목은 휴지통에 있을 수 없습니다.
각 항목은 최대 10개의 웹후크를 포함할 수 있습니다.
웹후크 생성
다음 테이블에는 호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블의 웹후크를 생성하고 관리할 수 있는 기관 구성원 유형과 웹후크를 관리할 수 있는 위치 관련 정보가 나와 있습니다.
| 기관 구성원 유형 | 웹후크를 관리할 수 있는 위치 |
|---|---|
기본 관리자 역할의 구성원 또는 웹후크를 생성하고 관리할 수 있는 관리 권한이 있는 사용자 설정 역할의 구성원. |
|
항목의 소유자 |
|
항목이 공유된 공유 업데이트 그룹의 구성원 | 호스팅 피처 레이어, 뷰, 테이블 항목 페이지의 설정 탭 — 그룹 구성원은 특정 항목의 웹후크를 생성하고 관리할 수 있습니다. |
웹후크를 생성하려면 기관에서 해당 역할에 맞는 지침을 따르세요.
- 기관 관리자
- 항목이 공유된 공유 업데이트 그룹의 항목 소유자 또는 구성원