소개: PhotoRobot Cloud용 고객 웹훅

PhotoRobot은 PhotoRobot Cloud용 고객 웹훅을 도입하여 DAM, PIM, ERP 또는 맞춤형 자동화를 서명된 아웃바운드 웹훅과 연결할 수 있습니다.

시간을 절약하고 이 페이지의 내용을 요약하세요

도구를 선택하여 이 페이지의 요약을 생성합니다.

PhotoRobot Cloud용 고객 웹훅

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

‍

‍

스튜디오와 시스템 간의 루프를 닫으세요

항목 상태 변경이나 호스팅 가용성 이벤트가 발생하면 하위 시스템이 이를 인지하도록 하세요. PhotoRobot Cloud 고객 웹훅은 각 이벤트를 엔드포인트에 전달하여 통합이 폴링 기반이 아닌 이벤트 중심으로 유지되도록 합니다.

라이브 이벤트는 다음과 같습니다:

item.status.changed – 한 항목에 대해 커밋된 캡처-상태 변경.
item.status.bulk_changed — 클라우드 대량 상태 변경 후 한 번의 이벤트.
hosting.item.availability.changed — 호스팅된 미디어가 다운로드 가능하거나 사용할 수 없게 되었습니다.
webhook.subscription.test — 테스트 전송만 하세요.

‍

‍

신뢰할 수 있는 이벤트 기반 데이터 전달

PhotoRobot Cloud의 고객 웹훅에는 다음과 같은 기능이 포함되어 있습니다:

아웃바운드 웹훅 구독은 개발자 통합과 함께 관리됩니다.
수신자가 진위를 확인할 수 있도록 서명된 HTTP 전달.
"테스트 전송" 및 웹 훅 구독 및 서명 검증을 위한 필터를 사용합니다.
전송 로그 를 통해 페이로드, HTTP 상태, 재전송 등을 점검합니다.
Webhooks 하의 개발자 UI — 웹 훅과 배포는 API 키 옆에 위치해 있습니다.

‍

‍

프로덕션 통합을 위한 당신의 언어로 말하기

고객 웹훅은 로봇화된 캡처와 회사 기록 시스템 사이의 빠진 연결고리입니다. 웹훅은 서명된 신호로, 의도적으로 작은 페이로드만 전달합니다. 2xx 이후에는 통합이 REST v2에서 현재 항목을 끌어옵니다 (pull.itemUrl / pull.deltaUrl). 웹훅은 퍼블리셔에 알림을 보내거나, 풀 후 팀이 CDN 정리를 시작하거나 마켓플레이스 목록을 업데이트하는 데 도움을 줄 수 있습니다. PhotoRobot Cloud는 이제 운영 통합을 위한 귀하의 언어를 이해합니다.

‍

‍

신호, 그리고 당김

페이로드는 의도적으로 작게 유지됩니다. 각 페이로드는 이벤트, 조직, 그리고 (관련 있을 경우) 아이템 이름과 pull.itemUrl , pull.deltaUrl 이름을 표시합니다. 페이로드는 이미지 바이너리, 전체 폴더 트리, 완전한 제품 레코드를 포함 하지 않습니다 .

개발자가 구현해야 할 패턴은 다음과 같습니다:

POST를 받고 X-PhotoRobot-Signature를 원시 본체와 대조해 검증하세요.
2xx를 빠르게 반납하세요 — 자신의 작업자에서 DAM 가져오기나 마켓플레이스 업데이트를 하세요.
이벤트 ID로 중복 제거. 배달은 최소 한 번입니다.
풀 URL을 이용해 REST v2 호스팅에서 현재 상태를 가져오세요.

이 분할이 통합을 신뢰성 있게 만듭니다. PhotoRobot은 카탈로그 작업이 완료되기를 기다리지 않으며, 시스템은 알림을 카탈로그로 간주하지 않습니다.

‍

‍

고객 웹훅의 일반적인 사용 예시

PhotoRobot 생태계에서 고객 웹훅의 가장 일반적인 사용 사례는 다음과 같습니다:

PIM 또는 DAM 새로고침을 하세요. hosting.item.availability.changed 구독하세요. 호스팅된 미디어가 다운로드 가능해지면 itemUrl을 뽑아 제품을 업데이트하세요 — 회전, 정지, 메타데이터를 한 번에 처리하세요.
마켓플레이스 목록. 이벤트 호스팅 항목을 "다운로드 가능해짐"으로 필터링하세요. PhotoRobot이 실제로 이미지를 제공할 수 있을 때만 목록을 게시하거나 업데이트하세요.
프로덕션 보드 가시성. ERP나 QC 보드가 항목을 편집, 승인, 게시로 변경해야 할 때 item.status.changed를 구독하세요 — 호스팅 준비가 되기 전에도요.
대량 캠페인 업데이트. 클라우드에서 큰 상태 변화가 발생한 후, item.status.bulk_changed 이벤트 하나가 deltaUrl을 포함해 도착합니다. 수천 개의 항목당 웹훅을 기대하지 말고 영향을 받은 세트를 따라잡으세요.
캐시 또는 CDN 무효화. 호스팅이 사용 가능 또는 사용 불가로 전환될 때, 스토어프론트가 이미 알고 있는 경로를 정리하거나 워밍하세요. 웹훅이 트리거이며; 호스팅 API가 새로운 URL의 소스입니다.

‍