eIDAS 전자서명 API — Certyneo Developers

curl https://api.certyneo.com/v1/envelopes \ -H "Authorization: Bearer $CERTYNEO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Contrat de prestation", "documents": [{"file_url": "https://your.app/contract.pdf"}], "recipients": [{"email": "client@example.com", "name": "Jane Doe"}], "webhook_url": "https://your.app/webhooks/sign" }'

import Certyneo from '@certyneo/sdk'; const client = new Certyneo({ apiKey: process.env.CERTYNEO_API_KEY }); const envelope = await client.envelopes.create({ title: 'Contrat de prestation', documents: [{ file_url: 'https://your.app/contract.pdf' }], recipients: [{ email: 'client@example.com', name: 'Jane Doe' }], }); console.log(envelope.sign_url); // ready to share with the signer

웹후크 실시간으로 반응하세요

6개의 이벤트 (envelope.sent, viewed, signed, completed, declined, expired) 를 통해 HMAC 서명 검증과 자동 재시험을 합니다.

envelope.completed

{
  "event": "envelope.completed",
  "envelope_id": "env_3a2f...",
  "signed_at": "2026-05-25T14:32:18Z",
  "evidence_url": "https://api.certyneo.com/v1/envelopes/env_3a2f.../audit-trail.pdf",
  "signers": [
    { "email": "client@example.com", "signed": true, "ip": "82.x.x.x" }
  ]
}

HMAC SHA-256 서명 각 페이로드의 서버 측에서 인증합니다.

실패할 경우 자동 재시험: 24시간 동안 5번 시도해 보죠.

이드보드에서 볼 수 있는 이벤트 로그: 모든 시도, 반환된 HTTP 상태, 본부를 볼 수 있습니다.

프로젝트에서 덮어쓰거나 전용으로 구성할 수 있는 웹후크 URL

왜 전자서명 API를 만들까요?

전자 서명을 제품으로 통합하는 것은 쉬운 일이 아닙니다. 법적 준수 (eIDAS), 기술 신뢰성 (실제로 도착하는 웹 룩), 데이터 주권 (클라우드 법을 피하기 위해 유럽 호스팅) 에 대한 보장이 필요합니다. Certyneo API는 세 가지를 모두 포함합니다.

개발자들에 의해 개발된 것이기에, 현대적인 REST 규정을 따르고 있습니다. 커서 기반 페이지링, 아이템포텐시 키, URL 버전링, OpenAPI 3.1로 자동으로 클라이언트를 생성합니다.

개발자에게 설명된 eIDAS 준수

eIDAS 규정은 세 가지 서명 수준을 정의합니다: 단순 (SES), 고급 (AES), 그리고 자격 (QES). Certyneo API는 `신명_ 레벨` 필드를 통해 봉투별로 레벨을 선택할 수 있습니다. 기본 값은 AES입니다 (B2B 사례의 95%에 충분합니다). QES는 손으로 작성된 서명과 엄격한 법적 동등성을 필요로하는 문서 (신문서, 공공 계약) 에 사용할 수 있습니다.

기술적으로 AES는 강력한 서명자 인증 (디فال트 문자 메시지 OTP, 선택적인 비디오 KYC) 과 시간표시된 감사 트랙을 요구합니다. QES는 EU 자격의 TSP에서 발행한 자격증을 추가합니다. 이 모든 것이 API에 의해 관리됩니다. 당신은 엔드포인트에 전화를 걸고 나머지는 처리됩니다.

무료 샌드박스 무제한

샌드박스 환경은 무료이며 무제한입니다. 서명에는 법적 가치가 없습니다 (PDF는 SANDBOX로 표시됩니다) 를 제외하고 모든 생산 기능이 제공됩니다. 자동 테스트, 클라이언트 데모, 로컬 개발에 적합합니다. 샌드박스 키는 프로드 키와 분리되어 있으며 둘 사이에 완전한 고립입니다.

DocuSign 또는 Yousign에서 마이그레이션

이미 DocuSign 또는 Yousign 통합을 가지고 있다면, API 매핑은 간단합니다: 봉투 → 봉투, 수신자 → 수신자, 상태 웹후크 → 상태 웹후크. 우리의 마이그레이션 가이드에서는 엔드포인트별로 동등한 내용을 문서화합니다. 전체 마이그레이션에 1~3일 정도 걸립니다. 내부 래퍼를 사용하는 경우 훨씬 더 짧습니다.

질문 API

API의 빗자루 한계점은 무엇일까요?

1 000개의 요청이 1분당 기본으로, 높은 사용량 (공장, 다중 사용자 플랫폼) 에 따라 요구에 따라 증가할 수 있다. 각 응답의 X-RateLimit-Remaining 헤더는 남은 쿼타를 나타낸다. 이수를 넘으면 API는 429을 리트리-아프터로 반환한다.

API는 얼마죠?

샌드박스는 무료이며 무제한이다. 생산은 서명에 따라 지불 (용량 감소와 함께 AES 서명 0.40 €부터) 으로 작동하며 최소 구독이 없습니다. 엔터프라이즈 계획에는 강화된 SLA, IP 백계 및 전용 기술 계정이 포함되어 있습니다.

ALS가 있나요?

비즈니스 및 엔터프라이즈 계획의 99.95% 업타임 (연간 최대 4시간 다운타임). 공공 상태 페이지와 사건 기록: status.certyneo.com. 엔터프라이즈 계획에는 SLA를 준수하지 않는 경우 자동 신용이 포함되어 있습니다.

어떤 인증서 사용하세요?

Bearer token (API 키) in the authorization header. 키는 대시보드에서 바로 취소할 수 있습니다. OAuth (다중 주체 플랫폼) 통합을 위해 우리는 엔터프라이즈 계획에서 OAuth 2.0 클라이언트 자격증을 제공합니다.

웹후크의 HMAC 서명을 어떻게 확인해야 할까요?

각 웹후크에는 X-Certyneo-Signature 헤더가 포함되어 있으며, 이 헤더에는 페이로드의 HMAC SHA-256이 포함되어 있으며, 비밀 웹후크로 서명되어 있습니다. 서버 측에서는 HMAC를 재 계산하고, 일정 시간에 비교합니다. 공식 SDK는 webhook.verify(payload, signature, secret를 통해 자동으로 이 작업을 수행합니다.

SDK는 오픈 소스인가요?

네. 노드, 파이썬, 루비 SDK는 MIT 라이선스에 따라 GitHub에 있습니다. 당신은 그들을 포크, 기여하거나 단순히 감사 할 수 있습니다. 바이너리는 @certyneo / certyneo 네임스페이스 아래 npm, PyPI 및 RubyGems에 게시됩니다.

등록 없이 테스트해도 될까요?

예, API 문서의 상호 작용 예제: /developers/playground를 통해요. 여기서 요청은 공유 샌드박스 인스턴스에 대해 진행됩니다. 키가 필요하지 않습니다. 심각한 사용은 무료 개발자 계정을 만들십시오. (한정없는 샌드박스).

개발자를 위한 전자 서명 API

REST + OpenAPI 3.1

신뢰할 수 있는 웹 룩

네이티브 eIDAS 준수

대기시간 < 200ms

5분 안에 시작