Certyneo(미리 보기)
eIDAS 규격 전자 서명에 대한 문서를 보내고, 템플릿에서 봉투를 만들고, 전송, 서명, 완료 및 거부와 같은 서명 이벤트에 대한 흐름을 트리거합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | Standard | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| Name | Certyneo 지원 |
| URL | https://certyneo.com/fr/contact |
| support@certyneo.com |
| 커넥터 메타데이터 | |
|---|---|
| Publisher | Certyneo |
| 웹 사이트 | https://certyneo.com |
| 개인 정보 보호 정책 | https://certyneo.com/fr/legal/privacy |
| 카테고리 | IT 작업; 생산력 |
Certyneo
Certyneo는 eIDAS 규격 전자 서명 서비스입니다. 이 커넥터를 사용하면 흐름에서 서명을 위해 문서를 보내고, 서명자가 동작할 때 실시간으로 반응하고, 나머지 비즈니스에서 레코드를 보관할 때마다 서명된 PDF 및 증거 파일을 제출할 수 있습니다.
일반적인 흐름은 문서가 어딘가에 착륙하고(문서 라이브러리, 사서함, 양식 제출), 흐름이 봉투를 만들고 보내고, 서명된 PDF를 다운로드하여 envelope.completed 트리거되는 두 번째 흐름의 세 가지 단계입니다.
Publisher
Certyneo
Prerequisites
API 액세스를 포함하는 플랜에 Certyneo 계정이 필요합니다. 무료 및 개인 플랜은 API 키를 만들고 이벤트를 구독할 수 있지만 샌드박스 봉투에 대한 이벤트만 수신합니다. 아래 알려진 문제 및 제한 사항을 참조하세요.
자격 증명을 가져오는 방법
커넥터는 Certyneo API 키를 사용하여 인증합니다.
- Certyneo에 로그인하고 설정 → API 키를 엽니다.
- 키를 만듭니다. 라이브 키는
sk_live_sk_test_. - 커넥터가 API 키를 요청하면 단어
Bearer, 공백 및 키를 붙여넣습니다. 예를 들면 다음과 같습니다Bearer sk_live_abc123. Certyneo는 키 앞에 단어를Bearer기대하며, 자체적으로 붙여넣은 키는 401로 거부됩니다.
키는 범위를 전달합니다. 키가 없는 envelopes:write 키는 만들거나 보낼 수 없으며, 키가 없는 webhooks:write 키는 트리거를 되돌릴 수 없습니다. 흐름에 실제로 필요한 범위를 부여합니다.
누구에게도 전자 메일을 보내지 않고 테스트
샌드박스 키(sk_test_)는 단일 초대 이메일을 보내지 않고 전체 파이프라인을 실행합니다. 실제 받은 편지함에 도달한 항목이 없습니다. 즉, 전자 메일에서 서명 페이지에 연결할 수 없으므로 봉투 만들기 및 봉투 보내기 는 각 받는 사람에 대한 액세스 토큰을 대신 반환합니다. 테스트 봉투에 직접 서명하려면 엽니다 https://certyneo.com/sign/<access token> .
해당 토큰을 자격 증명으로 처리합니다. 토큰을 보유한 사람은 누구나 해당 수신자로 서명할 수 있습니다. 로그하지 말고 스프레드시트에 놓지 마세요.
지원되는 작업
Trigger
봉투 이벤트가 발생하면 선택한 이벤트에서 발생하며 폴링이 아닌 실제 웹후크에서 지원됩니다. 사용 가능한 이벤트:
envelope.created, envelope.sent,envelope.completed, envelope.declined, envelope.voided, envelope.expired, envelope.returned_to_sender, envelope.resubmittedrecipient.signed, recipient.viewedrecipient.approved.
모든 페이로드는 봉투 및 받는 사람 이벤트 모두에 봉투 ID를 전달합니다. 즉, 아래 작업에 피드할 값입니다.
배달은 구독 비밀로 키가 지정된 원시 JSON 본문의 16진수 다이제스트인 헤더의 HMAC-SHA256 X-Certyneo-Signature 사용하여 서명됩니다. 흐름이 페이로드에서 작동하기 전에 확인합니다.
조치
| 조치 | 용도 |
|---|---|
| 목록 템플릿 | 저장된 봉투 서식 파일입니다. 템플릿 선택기를 구동합니다. |
| 봉투 만들기 | 템플릿 또는 업로드된 문서에서 DRAFT 봉투를 만듭니다. |
| 봉투 보내기 | 받는 사람에게 DRAFT 봉투를 디스패치합니다. |
| 봉투 가져오기 | 현재 상태 및 받는 사람 세부 정보입니다. |
| 봉투 나열 | 페이지를 매긴 목록으로, 상태별로 필터링할 수 있습니다. |
| 문서 업로드 | PDF 또는 이미지를 업로드하고 문서 ID를 반환합니다. |
| 서명된 문서 다운로드 | 서명된 PDF, 인증서 페이지가 포함되어 있습니다. |
| 감사 내역 다운로드 | 증거 파일: 서명한 사람, 언제, 어떤 IP에서 어떤 요소가 포함됩니다. |
| 초안 봉투 삭제 | 전송되지 않은 봉투를 삭제합니다. |
알려진 문제 및 제한 사항
보낸 봉투는 흐름에서 회수할 수 없습니다.임시 봉투 삭제 는 임시 보관함에 있는 봉투만 허용합니다( 중간에 실패한 흐름, 잘못된 문서). 봉투가 나가면 409가 반환되며 현재 API에는 취소 작업이 없습니다.
recipient.signed 마지막 서명자를 포함하여 서명된 PDF가 존재하기 전에 발생합니다. 최종 문서 어셈블 및 봉인은 해당 이벤트 이후에 발생하므로 서명된 문서 다운로드를 recipient.signed 트리거하고 즉시 호출하는 흐름은 매번 409를 가져옵니다. 이것은 지연으로 이길 수 있는 경주가 아니며, 대신 트리거되며 PDF가 디스크에 envelope.completed 있으면 발생합니다.
무료 및 개인 플랜은 샌드박스 이벤트만 받습니다. 둘 다 구독을 만들 수 있으며 트리거는 정상으로 표시되지만 라이브 봉투는 해당 구독에 도달하지 않습니다. 트리거가 실제 트래픽에 대해 아무 작업도 수행하지 않는 것처럼 보이면 다른 작업 전에 계획을 확인합니다.
템플릿 또는 문서를 모두 사용하지 마세요. 템플릿은 자체 문서 와 자체 서명 필드를 제공합니다. 대신 업로드된 문서에서 빌드하는 경우 필드를 제공해야 합니다. 서명자가 서명할 곳이 없는 봉투는 생성 시간이 아닌 409 signer_without_field로 전송 시 거부됩니다.
좌표보다 앵커 텍스트를 사용하는 것이 좋습니다. 문서의 구("Signature du client")를 따옴표로 묶어 필드를 배치하면 레이아웃 변경이 유지되며 측정할 필요가 없습니다. X와 Y는 대체(fallback)로 유지되므로 앵커를 찾을 수 없는 필드는 사라지는 대신 리터럴 위치를 유지합니다.
업로드는 문서당 50MB로 제한됩니다 .
제거된 문서는 409가 아닌 410을 반환합니다. 409는 "아직 준비되지 않음, "후에 envelope.completed돌아오라"를 의미합니다. 410은 서명된 문서가 보존 정책에 따라 의도적으로 삭제되었으며 다시는 돌아오지 않음을 의미합니다. 재시도 루프는 410을 포기해야 합니다.
일반적인 오류 및 해결
| Response | 원인 | 해결 방법 |
|---|---|---|
| 401 | 키가 누락되었거나 앞에 붙여넣지 않은 경우 Bearer |
연결을 다음으로 다시 입력합니다. Bearer sk_live_... |
| 403 | 키에 이 작업의 범위가 없습니다. | 흐름에 필요한 범위로 키를 다시 발급합니다. |
| 다운로드할 때 409 | 봉투가 아직 완료되지 않았습니다. | 폴링 대신 트리거 envelope.completed |
| 409 보내기 |
signer_without_field — 서명자에 서명 필드가 없습니다. |
필드 추가 또는 템플릿에서 빌드 |
| 삭제할 때 409 | 봉투가 이미 전송되었습니다. | 보낸 봉투는 삭제하거나 회수할 수 없습니다. |
| 다운로드할 때 410 | 문서가 보존 정책에 따라 제거되었습니다. | 다시 시도 중지; 파일이 사라졌습니다. |
오류는 사람이 읽을 수 error 있는 메시지와 안정적인 code메시지를 모두 전달합니다. 분기 켜 code 기 - 메시지를 다시 표시할 수 있습니다.
Support
- 문서: https://certyneo.com/developers
- 웹후크 참조: https://certyneo.com/developers/webhooks
- 고객 지원: https://certyneo.com/support
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| Name | Type | Description | Required |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | True |
actions
| 감사 내역 다운로드 |
완료된 봉투에 대한 증명 정보 파일을 가져옵니다. 누가 서명하고, 언제, 어떤 IP에서 인증 요소를 갖는지 확인합니다. 서명된 PDF와 함께 보관합니다. eIDAS 분쟁이 켜지는 것입니다. |
| 목록 템플릿 |
저장된 봉투 서식 파일을 반환합니다. "봉투 만들기"에서 템플릿 선택기 전원을 공급하는 데 사용됩니다. |
| 문서 업로드 |
PDF 또는 이미지(최대 50MB)를 업로드합니다. 문서 ID를 반환하여 "문서" 아래의 "봉투 만들기"에 전달합니다. |
| 봉투 가져오기 |
봉투의 현재 상태 및 세부 정보를 가져옵니다. |
| 봉투 나열 |
페이지를 매긴 봉투 목록을 검색합니다. |
| 봉투 만들기 |
저장된 서식 파일에서 또는 "문서 업로드"를 사용하여 업로드한 문서에서 바로 초안 상태로 새 봉투를 만듭니다. "서식 파일" 또는 "문서" 중 하나를 입력합니다. 문서를 사용하면 각 서명자가 서명할 위치에 "필드"를 추가합니다. 가장 간단한 방법은 좌표를 사용하는 대신 문서의 구문을 "앵커 텍스트"로 인용하는 것입니다. 중요: 이 작업은 봉투만 만듭니다. 전자 메일은 아직 전송되지 않습니다. 흐름에서 이 작업 바로 뒤의 "봉투 보내기" 작업을 추가하여 실제로 받는 사람에게 디스패치합니다. |
| 봉투 보내기 |
서명을 위해 받는 사람에게 DRAFT 봉투를 디스패치합니다. 이 단계는 실제로 전자 메일을 보내는 단계입니다. "봉투 만들기"는 초안으로만 저장합니다. 자체적으로 아무것도 보내지 않습니다. 항상 반환된 봉투 ID를 사용하여 흐름에서 "봉투 만들기" 바로 후에 이 작업을 연결합니다. |
| 서명된 문서 다운로드 |
서명된 PDF, 인증서 페이지를 가져옵니다. 봉투가 완료된 후에만 409를 반환하므로 폴링이 아닌 "Envelope completed"에서 트리거됩니다. |
| 초안 봉투 삭제 |
전송되지 않은 봉투(중간에 실패한 흐름, 잘못된 문서)를 삭제합니다. DRAFT만: 봉투가 나가면 오류가 반환되고 흐름에서 회수할 수 없습니다. |
감사 내역 다운로드
완료된 봉투에 대한 증명 정보 파일을 가져옵니다. 누가 서명하고, 언제, 어떤 IP에서 인증 요소를 갖는지 확인합니다. 서명된 PDF와 함께 보관합니다. eIDAS 분쟁이 켜지는 것입니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
봉투 ID
|
id | True | string |
감사 내역을 다운로드하려는 봉투의 식별자입니다. |
반품
- response
- binary
목록 템플릿
문서 업로드
PDF 또는 이미지(최대 50MB)를 업로드합니다. 문서 ID를 반환하여 "문서" 아래의 "봉투 만들기"에 전달합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
File
|
file | True | file |
업로드할 PDF 또는 이미지로, 최대 50MB입니다. |
|
문서 이름
|
name | string |
문서를 제출할 이름입니다. 기본적으로 업로드된 파일의 고유한 이름으로 설정됩니다. |
반품
- 몸
- Document
봉투 가져오기
봉투의 현재 상태 및 세부 정보를 가져옵니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
봉투 ID
|
id | True | string |
검색할 봉투의 식별자입니다. |
반품
- 몸
- Envelope
봉투 나열
페이지를 매긴 봉투 목록을 검색합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
페이지
|
page | integer |
반환할 결과의 페이지입니다. 1에서 시작합니다. |
|
|
페이지 크기
|
limit | integer |
페이지당 반환할 봉투 수입니다. |
|
|
상태
|
status | string |
이 상태의 봉투만 반환합니다. 모든 상태를 반환하려면 비워 둡니다. |
반품
봉투 만들기
저장된 서식 파일에서 또는 "문서 업로드"를 사용하여 업로드한 문서에서 바로 초안 상태로 새 봉투를 만듭니다. "서식 파일" 또는 "문서" 중 하나를 입력합니다. 문서를 사용하면 각 서명자가 서명할 위치에 "필드"를 추가합니다. 가장 간단한 방법은 좌표를 사용하는 대신 문서의 구문을 "앵커 텍스트"로 인용하는 것입니다. 중요: 이 작업은 봉투만 만듭니다. 전자 메일은 아직 전송되지 않습니다. 흐름에서 이 작업 바로 뒤의 "봉투 보내기" 작업을 추가하여 실제로 받는 사람에게 디스패치합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제
|
subject | True | string |
봉투 제목/제목입니다. |
|
Message
|
message | string |
받는 사람에게 표시되는 메시지입니다. |
|
|
Template
|
templateId | string |
저장된 템플릿을 선택합니다. 템플릿은 자체 문서와 서명 필드를 제공하는 것이 아니라 이 OR "문서"를 사용합니다. |
|
|
Documents
|
documentIds | array of string |
"문서 업로드"의 문서 ID입니다. 이 또는 "템플릿"을 모두 사용하지 않습니다. 문서를 사용하는 경우 서명자가 서명 필드가 없는 봉투인 "필드"도 추가합니다. |
|
|
서명자 전자 메일
|
recipientEmail | True | string |
위의 받는 사람 중 하나와 정확히 일치해야 합니다. |
|
문서 번호
|
documentIndex | integer |
이 필드를 전달하는 문서는 위에서 지정한 순서대로 0부터 계산됩니다. 문서가 하나만 있는 경우 비워 둡니다. |
|
|
페이지
|
pageNumber | True | integer | |
|
필드 유형
|
fieldType | True | string | |
|
앵커 텍스트(권장)
|
anchorText | string |
문서에서 찾을 텍스트 - 필드가 옆에 배치되므로 좌표가 필요하지 않습니다. 대/소문자를 구분하지 않으며 PDF가 구를 실행 간에 분할하는 경우에도 발견됩니다. 대신 X/Y를 사용하려면 비워 둡니다. |
|
|
앵커 배치
|
anchorPlacement | string |
앵커 텍스트를 기준으로 필드를 배치할 위치입니다. |
|
|
앵커 발생
|
anchorIndex | integer |
앵커 텍스트가 여러 번 나타날 때 사용할 항목(0부터 계산)입니다. |
|
|
X
|
x | True | number |
왼쪽 가장자리의 점입니다. 앵커가 발견되면 무시됩니다. 필드가 사라지지 않도록 대체(fallback)로 유지됩니다. |
|
Y
|
y | True | number |
위쪽 가장자리의 점입니다. 앵커가 발견되면 무시됩니다. 대체(fallback)로 유지됩니다. |
|
너비
|
width | True | number | |
|
높이
|
height | True | number | |
|
받는 사람 전자 메일
|
True | string | ||
|
수신자 이름
|
name | string | ||
|
역할
|
role | string | ||
|
상태
|
status | string | ||
|
signedAt
|
signedAt | string | ||
|
액세스 토큰
|
accessToken | string |
토큰>에서 https://certyneo.com/sign/<이 받는 사람의 서명 페이지를 엽니다. 샌드박스에서 초대 전자 메일이 나가지 않으므로 테스트 봉투에 직접 서명하는 방법입니다. "봉투 가져오기"가 아닌 "봉투 만들기" 및 "봉투 보내기"에서 반환됩니다. 자격 증명으로 처리합니다. 자격 증명을 보유한 사람은 누구나 이 받는 사람으로 서명할 수 있으므로 로그하거나 스프레드시트에 놓지 마세요. |
|
|
서명 수준
|
signatureLevel | string | ||
|
만료 날짜
|
expiresAt | date-time | ||
|
카테고리
|
category | string |
봉투 목록에 표시된 비즈니스 분류입니다. 빈 상태로 두고 Certyneo는 제목에서 하나를 유추합니다. |
|
|
태그
|
tags | array of string |
자유 형식 레이블 ( 프로젝트 코드, 고객 참조, 내부 상태) 최대 10자, 각각 최대 40자. 소문자 및 중복 제거된 서버 쪽. |
|
|
언어
|
locale | string |
서명자가 보는 모든 언어: 서명 페이지, 초대, 미리 알림, 완료 전자 메일. BCP-47 코드(예: nl, nl-BE, en-GB, de, fr) 봉투를 보내는 Certyneo 계정의 언어를 상속하려면 비워 둡니다. 지원되지 않는 코드는 400으로 거부됩니다. |
|
|
리디렉션 URL
|
redirectUrl | string |
서명 후 서명자가 전송되는 위치입니다. 기본 Certyneo 실행 호출을 여기를 가리키는 단일 "계속" 단추로 바꿉니다. https:// 시작해야 합니다. 다른 항목은 400으로 거부됩니다. |
|
|
모든 페이지의 이니셜
|
initialsOnEveryPage | boolean |
직접 배치하는 필드 외에도 모든 문서의 모든 페이지 아래쪽에 서명자의 이니셜을 자동으로 스탬프합니다. 페이지별 설정이 필요하지 않습니다. 서명자는 이니셜을 한 번 채우고 모든 곳에 적용됩니다. 서명자에게 이미 필드가 있는 페이지(예: 마지막 페이지의 서명)를 건너뜁니다. |
|
|
Workspace
|
workspaceId | string |
공유 작업 영역에 봉투를 만들어 해당 작업 영역의 모든 구성원이 보고 추적할 수 있도록 합니다. 자신의 계정에 보관하려면 비워 둡니다. 작업 영역을 소유하거나 작업 영역의 구성원이어야 합니다. |
반품
- 몸
- Envelope
봉투 보내기
서명을 위해 받는 사람에게 DRAFT 봉투를 디스패치합니다. 이 단계는 실제로 전자 메일을 보내는 단계입니다. "봉투 만들기"는 초안으로만 저장합니다. 자체적으로 아무것도 보내지 않습니다. 항상 반환된 봉투 ID를 사용하여 흐름에서 "봉투 만들기" 바로 후에 이 작업을 연결합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
봉투 ID
|
id | True | string |
받는 사람에게 디스패치할 초안 봉투의 식별자입니다. |
반품
- 몸
- Envelope
서명된 문서 다운로드
서명된 PDF, 인증서 페이지를 가져옵니다. 봉투가 완료된 후에만 409를 반환하므로 폴링이 아닌 "Envelope completed"에서 트리거됩니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
봉투 ID
|
id | True | string |
서명된 문서를 다운로드하려는 봉투의 식별자입니다. |
반품
- response
- binary
초안 봉투 삭제
전송되지 않은 봉투(중간에 실패한 흐름, 잘못된 문서)를 삭제합니다. DRAFT만: 봉투가 나가면 오류가 반환되고 흐름에서 회수할 수 없습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
봉투 ID
|
id | True | string |
삭제할 초안 봉투의 식별자입니다. |
반품
트리거
| 봉투 이벤트가 발생하는 경우 |
선택한 이벤트 중 하나가 봉투(예: 서명됨, 완료됨, 거부됨)에서 발생할 때마다 흐름을 트리거합니다. 실시간 웹후크에 의해 지원됩니다. 폴링이 없습니다. |
봉투 이벤트가 발생하는 경우
선택한 이벤트 중 하나가 봉투(예: 서명됨, 완료됨, 거부됨)에서 발생할 때마다 흐름을 트리거합니다. 실시간 웹후크에 의해 지원됩니다. 폴링이 없습니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Events
|
events | True | array of string |
이 흐름을 트리거해야 하는 봉투/받는 사람 이벤트입니다. |
반품
X-Certyneo-Signature 헤더에서 HMAC-SHA256 서명하여 전달됩니다(원시 JSON 본문의 16진수 다이제스트, 구독의 비밀로 키 지정). 작업하는 흐름에서 페이로드를 신뢰하기 전에 확인합니다(/developers/webhook 참조).
정의
DeleteResult
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
Success
|
success | boolean |
리소스가 삭제된 경우 True입니다. |
Pagination
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
총
|
total | integer | |
|
페이지
|
page | integer | |
|
pageSize
|
pageSize | integer | |
|
pages
|
pages | integer |
Template
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | string | |
|
name
|
name | string | |
|
description
|
description | string | |
|
signerCount
|
signerCount | integer | |
|
documentCount
|
documentCount | integer |
TemplateList
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
data
|
data | array of Template | |
|
페이지 매김
|
pagination | Pagination |
Recipient
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
받는 사람 전자 메일
|
string | ||
|
수신자 이름
|
name | string | |
|
역할
|
role | string | |
|
상태
|
status | string | |
|
signedAt
|
signedAt | string | |
|
액세스 토큰
|
accessToken | string |
토큰>에서 https://certyneo.com/sign/<이 받는 사람의 서명 페이지를 엽니다. 샌드박스에서 초대 전자 메일이 나가지 않으므로 테스트 봉투에 직접 서명하는 방법입니다. "봉투 가져오기"가 아닌 "봉투 만들기" 및 "봉투 보내기"에서 반환됩니다. 자격 증명으로 처리합니다. 자격 증명을 보유한 사람은 누구나 이 받는 사람으로 서명할 수 있으므로 로그하거나 스프레드시트에 놓지 마세요. |
문서
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | string | |
|
name
|
name | string | |
|
마임 타입
|
mimeType | string | |
|
size
|
size | integer | |
|
상태
|
status | string |
봉투
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | string | |
|
subject
|
subject | string | |
|
메시지
|
message | string | |
|
상태
|
status | string | |
|
signatureLevel
|
signatureLevel | string | |
|
recipients
|
recipients | array of Recipient | |
|
expiresAt
|
expiresAt | string | |
|
createdAt
|
createdAt | string | |
|
completedAt
|
completedAt | string |
EnvelopeList
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
data
|
data | array of Envelope | |
|
페이지 매김
|
pagination | Pagination |
WebhookEventPayload
X-Certyneo-Signature 헤더에서 HMAC-SHA256 서명하여 전달됩니다(원시 JSON 본문의 16진수 다이제스트, 구독의 비밀로 키 지정). 작업하는 흐름에서 페이로드를 신뢰하기 전에 확인합니다(/developers/webhook 참조).
| 속성 | 경로 | 형식 | Description |
|---|---|---|---|
|
이벤트
|
event | string | |
|
timestamp
|
timestamp | date-time | |
|
봉투 ID
|
data.envelopeId | string |
항상 있습니다. "봉투 가져오기" 또는 "서명된 문서 다운로드"에 피드합니다. |
|
주제
|
data.subject | string |
봉투 이벤트에만 존재합니다. |
|
상태
|
data.status | string | |
|
서명 수준
|
data.signatureLevel | string |
envelope.completed 및 recipient.signed에 있습니다. |
|
개인 키가 있는 고급 서명 서명자
|
data.aesSignerCount | integer |
ENVELOPE.COMPLETE는 고급 봉투에서만 완료됩니다. |
|
고급 서명 인증서 직렬
|
data.aesCertificateSerial | string |
서명자가 개인 고급 서명 키로 서명할 때 recipient.signed입니다. |
|
고급 서명 인증서 SHA256
|
data.aesCertificateSha256 | string |
서명자가 개인 고급 서명 키로 서명할 때 recipient.signed입니다. |
|
고급 서명 매니페스트 SHA256
|
data.aesManifestSha256 | string |
서명자가 개인 고급 서명 키로 서명할 때 recipient.signed입니다. |
|
고급 서명 타임스탬프
|
data.aesTimestamped | boolean |
서명자가 개인 고급 서명 키로 서명할 때 recipient.signed입니다. |
|
받는 사람 수
|
data.recipientCount | integer |
봉투 이벤트에만 존재합니다. |
|
서명된 개수
|
data.signedCount | integer |
봉투 이벤트에만 존재합니다. |
|
받는 사람 ID
|
data.recipientId | string |
받는 사람 이벤트에만 존재합니다. |
|
받는 사람 전자 메일
|
data.email | string |
받는 사람 이벤트에만 존재합니다. |
|
수신자 이름
|
data.name | string |
받는 사람 이벤트에만 존재합니다. |
|
받는 사람 역할
|
data.role | string |
받는 사람 이벤트에만 존재합니다. |
|
서명된 위치에서
|
data.signedAt | date-time |
받는 사람 이벤트에만 존재합니다. |
|
에서 확인됨
|
data.viewedAt | date-time |
받는 사람 이벤트에만 존재합니다. |
binary
기본 데이터 형식 'binary'입니다.