메인 콘텐츠로 건너뛰기
모든 콜렉션통합API
디지파이 웹훅
디지파이 웹훅
Francesca Diyco avatar
작성자: Francesca Diyco
최소 10달 전에 업데이트됨

웹후크는 전송한 파일에 조회, 인쇄, 파일 다운로드 등의 이벤트가 발생했을 때 API 업데이트를 수신할 수 있도록 구독할 수 있는 알림입니다.

  1. 웹후크에 대한 적절한 설명

  2. 웹후크를 게시할 Digify용 URL

  3. 기본 인증을 위한 사용자 이름 및 비밀번호

Digify 웹후크는 다음 이벤트에서 전송됩니다:파일을 볼 때

  1. 파일이 인쇄된 경우

  2. 파일이 다운로드된 경우.

  3. 웹후크 이벤트에는 다음과 같은 속성이 포함됩니다:1.

웹후크 이벤트에는 다음과 같은 속성이 포함됩니다:1.

1. 액세스 유형 - 속성 값은 파일 권한 집합에 의해 결정됩니다.

  • 누구나 - 파일 링크가 있는 사람은 누구나 파일에 액세스할 수 있습니다. RecipientUserEmail, RecipientFirstName 및 RecipientLastName 속성은 비어 있습니다.

  • 이메일이 있는 모든 사람 - 파일 링크가 있고 이메일 주소를 제공한 모든 사람이 파일에 액세스할 수 있습니다. RecipientUserEmail 속성은 수신자가 제공한 이메일 주소를 반환합니다.

  • 인증된 사용자 - 이메일을 인증했거나 계정을 생성한 Digify 사용자는 파일에 액세스할 수 있습니다. RecipientUserEmail, RecipientFirstName 및 RecipientLastName 속성은 사용자의 세부 정보를 반환합니다.

(참고: 사용자가 이메일 주소를 인증했지만 Digify 계정을 만들지 않은 경우에는 RecipientFirstName에 수신자의 이메일 주소가 반환되고 RecipientLastName 속성은 비어 있습니다).

2. EventTime - 이벤트가 트리거된 시간입니다.

3. FileGUID - 전송된 파일에 할당된 ID입니다.

4. 파일 이름 - 전송된 파일의 이름입니다.

5. 링크 - 전송한 파일의 링크입니다.

6. 받는 사람 이름 - 받는 사람의 이름입니다.

7. 받는 사람 성 - 받는 사람의 성입니다.

8.받는 사람 사용자 이메일 - 받는 사람의 이메일 주소

9. 유형 - 웹훅 이벤트 유형입니다. 보기, 인쇄 또는 다운로드가 될 수 있습니다.

샘플 웹후크

보기 이벤트

보기 이벤트는 다음 시나리오에서 트리거됩니다:

  • 권한이 "제한"으로 설정된 경우, 각 수신자가 파일을 처음 열 때 웹후크가 전송됩니다.

  • 권한이 "공개"로 설정되어 있고 RequestEmail이 "false"로 설정되어 있으면 첫 번째 수신자가 파일을 열 때 웹후크가 전송됩니다.

  • 권한이 "공개"로 설정되어 있고 RequestEmail이 "true"로 설정되어 있으면 파일을 열 때마다 웹후크가 전송됩니다.

Content-Type: application/json
Accept-Encoding: gzip
Cf-Ray: 371d1ddc6be1192c-HKG
Cf-Visitor: {"scheme":"https"}
Authorization: Basic dGVzaDpEZW1vMTIzNA==
Connection: close
Total-Route-Time: 0
Host: requestb.in
Via: 1.1 vegur
Connect-Time: 0
Content-Length: 255
X-Request-Id: c7ab2411-da1b-4a4e-aa40-ebb227d3a443

{
"RecipientUserEmail": "tester1@email.com",
"RecipientFirstName": "Digify",
"RecipientLastName": "Tester1",
"FileGUID": "1f51447850d247d791a5d9c295af79c5",
"FileName": "secret.pdf",
"Type": "View",
"EventTime": "2017-06-20T07:46:50.6762428Z"
"AccessType": "Verified User"
}

인쇄 이벤트

인쇄 이벤트는 수신자가 파일을 인쇄할 때 트리거됩니다.

Content-Type: application/json
Accept-Encoding: gzip
Cf-Ray: 371d1ddc6be1192c-HKG
Cf-Visitor: {"scheme":"https"}
Authorization: Basic dGVzaDpEZW1vMTIzNA==
Connection: close
Total-Route-Time: 0
Host: requestb.in
Via: 1.1 vegur
Connect-Time: 0
Content-Length: 255
X-Request-Id: c7ab2411-da1b-4a4e-aa40-ebb227d3a443

{
"RecipientUserEmail": "tester1@email.com",
"RecipientFirstName": "Digify",
"RecipientLastName": "Tester1",
"FileGUID": "1f51447850d247d791a5d9c295af79c5",
"FileName": "secret.pdf",
"Type": "Print",
"EventTime": "2017-06-20T07:46:50.6762428Z"
"AccessType": "Verified User"
}

다운로드 이벤트

다운로드 이벤트는 수신자가 파일을 다운로드할 때 트리거됩니다.

Content-Type: application/json
Accept-Encoding: gzip
Cf-Ray: 371d1ddc6be1192c-HKG
Cf-Visitor: {"scheme":"https"}
Authorization: Basic dGVzaDpEZW1vMTIzNA==
Connection: close
Total-Route-Time: 0
Host: requestb.in
Via: 1.1 vegur
Connect-Time: 0
Content-Length: 255
X-Request-Id: c7ab2411-da1b-4a4e-aa40-ebb227d3a443

{
"RecipientUserEmail": "tester1@email.com",
"RecipientFirstName": "Digify",
"RecipientLastName": "Tester1",
"FileGUID": "1f51447850d247d791a5d9c295af79c5",
"FileName": "secret.pdf",
"Type": "Download",
"EventTime": "2017-06-20T07:46:50.6762428Z"
"AccessType": "Verified User"
}


번역은 인공 지능에 의해 생성되며 부정확한 내용이 포함될 수 있습니다.

답변이 도움되었나요?