출시 안내: PhotoRobot Cloud 고객 웹훅(Customer Webhooks)
PhotoRobot이 서명된 아웃바운드 웹훅으로 DAM, PIM, ERP 또는 맞춤형 자동화 시스템을 연동하는 PhotoRobot Cloud용 고객 웹훅(Customer Webhooks)을 선보입니다.
PhotoRobot Cloud 고객 웹훅(Customer Webhooks)
개발자와 IT 팀은 이제 PhotoRobot Cloud를 DAM, PIM, ERP, 또는 맞춤형 자동화에 서명된 아웃바운드 웹훅으로 연결할 수 있습니다. PhotoRobot Cloud의 고객 웹훅은 신뢰할 수 있는 이벤트 기반 데이터 전달을 제공하여 스튜디오와 시스템 간의 완전한 연결을 보장합니다.

스튜디오와 시스템 사이의 데이터 흐름을 완성하세요
항목 상태가 변경되거나 호스팅 가용성 이벤트가 발생할 때 하위 시스템이 이를 즉시 인지하도록 하십시오. PhotoRobot Cloud 고객 웹훅은 각 이벤트를 고객사의 엔드포인트로 전달하므로, 연동이 폴링 방식이 아닌 이벤트 기반으로 유지됩니다.
현재 사용 가능한 이벤트는 다음과 같습니다.
- item.status.changed – 단일 항목의 촬영 상태 변경이 확정되었습니다.
- item.status.bulk_changed — Cloud에서 상태를 일괄 변경한 후 발생하는 단일 이벤트입니다.
- hosting.item.availability.changed — 호스팅된 미디어를 다운로드할 수 있게 되었거나 사용할 수 없게 되었습니다.
- webhook.subscription.test — “Send test”에서만 전송됩니다.

이벤트 기반의 안정적인 데이터 전송
PhotoRobot Cloud의 고객 웹훅에는 다음 기능이 포함되어 있습니다.
- 아웃바운드 웹훅 구독을 개발자 연동 환경에서 함께 관리할 수 있습니다.
- 서명된 HTTP 전송으로 수신 측에서 진위를 검증할 수 있습니다.
- “Send test” 및 필터로 웹훅 구독과 서명 검증을 확인할 수 있습니다.
- 전송 로그에서 페이로드, HTTP 상태, 재시도 내역을 확인할 수 있습니다.
- Webhooks 메뉴의 개발자 UI — 웹훅과 전송 내역을 API 키 옆에서 바로 관리할 수 있습니다.

운영 환경 연동, 개발자의 언어로
고객 웹훅은 로봇 기반 촬영과 기업의 기준 데이터 시스템(system of record)을 잇는 빠져 있던 연결 고리입니다. 웹훅은 의도적으로 작은 페이로드만 담은 서명된 신호입니다. 2xx 응답 후 연동 시스템은 REST v2(pull.itemUrl / pull.deltaUrl)에서 최신 항목 정보를 가져옵니다. 웹훅은 퍼블리셔에게 알림을 보내거나, 데이터를 가져온 후 CDN 퍼지 실행 또는 마켓플레이스 상품 정보 업데이트를 팀이 시작하도록 지원할 수 있습니다. 이제 PhotoRobot Cloud는 운영 환경 연동에 필요한 방식을 그대로 지원합니다.

신호 수신 후 데이터 가져오기
페이로드는 의도적으로 작게 유지됩니다. 각 페이로드에는 이벤트, 조직, (해당하는 경우 항목)과 함께 pull.itemUrl 및 pull.deltaUrl이 포함됩니다. 페이로드에는 이미지 바이너리, 전체 폴더 구조, 완전한 제품 레코드가 포함되지 않습니다.
개발자가 구현해야 할 처리 방식은 다음과 같습니다.
- POST 요청을 수신하고 원본 본문(raw body)을 기준으로 X-PhotoRobot-Signature를 검증합니다.
- 2xx 응답을 신속하게 반환하고, DAM 가져오기나 마켓플레이스 업데이트는 자체 워커에서 처리합니다.
- 이벤트 ID를 기준으로 중복을 제거해 주십시오. 전송은 최소 한 번 이상 이루어지는 방식(at-least-once)입니다.
- 풀(pull) URL을 사용해 REST v2 호스팅에서 최신 상태를 가져옵니다.
이러한 분리 구조가 연동의 안정성을 높여 줍니다. PhotoRobot은 고객사의 카탈로그 작업이 끝나기를 기다리지 않으며, 고객사 시스템 역시 알림을 카탈로그 자체로 취급하지 않습니다.

Customer Webhooks 활용 사례
PhotoRobot 에코시스템에서 Customer Webhooks를 활용하는 대표적인 사례는 다음과 같습니다.
- PIM 또는 DAM 갱신 hosting.item.availability.changed를 구독하십시오. 호스팅된 미디어를 다운로드할 수 있게 되면 itemUrl을 가져와 스핀, 스틸 이미지, 메타데이터를 한 번에 제품 정보에 반영합니다.
- 마켓플레이스 상품 등록 호스팅 이벤트를 “Became downloadable”로 필터링하십시오. PhotoRobot이 이미지를 실제로 제공할 수 있게 된 이후에만 상품을 게시하거나 업데이트하십시오.
- 생산 현황 가시성 확보 ERP 또는 QC 보드에서 항목이 EDITED, APPROVED, PUBLISHED 상태로 이동했음을 알아야 한다면 item.status.changed를 구독하십시오. 호스팅이 준비되기 전에도 확인할 수 있습니다.
- 대량 캠페인 업데이트 Cloud에서 상태가 대규모로 변경되면 deltaUrl이 포함된 item.status.bulk_changed 이벤트가 한 번 전송됩니다. 항목별 웹훅 수천 건을 기다리는 대신, 영향을 받은 항목 집합을 한 번에 동기화하십시오.
- 캐시 또는 CDN 무효화 호스팅이 사용 가능 또는 사용 불가 상태로 전환되면 스토어프런트에서 이미 알고 있는 경로를 퍼지하거나 워밍하십시오. 웹훅은 트리거 역할을 하며, 새 URL의 출처는 Hosting API입니다.

Customer Webhooks 설정 방법
PhotoRobot Cloud용 고객 웹훅을 설정하려면 개발자 모드에서 PhotoRobot 계정을 열고 Webhooks를 사용해 웹훅 구독을 생성하세요. 그 후 구독을 스테이징 엔드포인트에 가리켜 첫 번째 배송을 검증하세요.

- PhotoRobot Account에 로그인하여 Developers → Webhooks를 엽니다.
- 웹훅을 생성합니다. HTTPS 엔드포인트를 붙여넣고 내부용 이름을 지정한 다음 필요한 이벤트를 선택합니다.
- 서명 시크릿이 표시되면 복사하십시오. 시크릿은 교체하기 전까지 한 번만 표시됩니다.
- Send test를 클릭합니다. webhook.subscription.test가 도착하고 서명이 검증되는지 확인합니다.
- Delivery log를 열어 페이로드, HTTP 상태, 재시도 내역을 확인합니다.
- 첫 번째 구독은 스테이징 엔드포인트로 지정합니다.

개발자 계약 및 서명 예시를 포함한 자세한 기술 정보는 PhotoRobot Developer Portal – Webhooks를 참조하십시오.

