メインコンテンツへスキップ
Certyneo
API REST eIDAS について

開発者向け電子署名API

REST,信頼性の高いウェブフック,ノード/パイソン/ルービー SDK,無料サンドボックス

開発者アカウントを作成 API 文書

無料サンドボックス · 99.95%アップタイム · EU主権ホスト

REST + OpenAPI 3.1 について

予測可能なエンドポイント,JSON,標準 HTTP コード,スペック OpenAPI 3.1 ダウンロード可能で,クライアントを生成できます

信頼性の高いウェブフック

自動復元 倍数バックオフ HMAC SHA-256 検索可能なイベント記録 暗号化されていない投票

生まれながらのeIDAS適合

AES,AES-Q,QES署名 APIフラグで入手可能.資格認証コースも含まれ,EU資格TSP証明書も含まれています.

遅延 < 200 ms

ストラスブール (EU) にホストされているAPI, p95 < 200ms ヨーロッパから.SLA 99.95%アップタイム,リアルタイム公開状態.

5分でスタート

最初の封筒を HTTP 要求で作成します

cURL 封筒を作成
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"
  }'

POST 要求だけで封筒を作成し,文書,署名者,ウェブフックの URL を追加できます.API は共有可能な sign_url を返します.

公式 Node.js SDK
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

Node TypeScript SDKは,完全なタイプ,自動エラー管理とリトライ,流動エンベーラーを構築する.また,PythonとRubyで利用可能.

ウェブフック リアルタイムで反応する

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" }
  ]
}
  • サーバー側で確認してください. サーバー側で確認してください.
  • 失敗した場合に自動再試行します 24時間以内に5回 倍数バックオフです
  • ダイッシュボードから検索できるイベントログ: 試みごとに HTTP 状態が返信され,ボディが表示されます
  • プロジェクト内のオーバーリードまたはグローバルで設定できる Webhook URL

なぜ電子署名専用のAPIを 開発したのでしょう?

電子署名を製品に組み込むことは簡単ではありません. 法的適合 (eIDAS),技術的信頼性 (Webhooksが実際にやってくる),データ主権 (クラウド法回避のための欧州のホスト) の保証が必要です. Certyneo APIは3つすべてをカバーします.

開発者向けに設計され 現代RESTのコンベンションに従います クーサーベースのページ付け, アイデンポテンシーキー, URLによるバージョン付け, OpenAPI 3.1でクライアントを自動的に生成します. SOAPもXMLも驚きもありません.

開発者向けに説明されたeIDAS適合性

eIDAS規則は,シンプル (SES),アドバンスト (AES),クваліficado (QES) の3つの署名レベルを定義しています.Certyneo APIでは,封筒ごとにレベルを選択できます. `サイン_レベル`のフィールドを介して. デフォルト値はAESです (B2Bケースの95%には十分です). QESは,手書きの署名と厳格な法的等価性を要求する文書 (公認文書,公的契約) に利用できます.

AESは技術的には,署名者の強力な認証 (OTPはSMSでデフォルトで,KYCはビデオでオプション) とタイムスタンプ付きのオーディト・トラックが必要です.QESにはEU資格のTSPが発行した資格証明書が追加されています.これはすべてAPIによって管理されています.端末に電話して,残りのことは処理されます.

推奨された統合アーキテクチャ

最も一般的な統合パターンは次の流れです

  • 包装を作成するために POST /v1/envelopes を呼び出し,ユーザに表示する sign_url を受信します.
  • ユーザを sign_url に転送したり,iframe に埋め込む (プロプランでのブランド化).
  • 署名が完了すると,Certyneoはあなたのウェブフックに envelope.completed イベントを呼び出します.
  • データベースを更新してユーザーに通知します (メール,アプリ内など)

無料のサンドボックス 無制限

サンドボックスの環境は無料で無制限です. サインが法的に有効でない (PDFはSANDBOXとマークされています) 以外,すべての生産機能が利用できます. 自動テスト,クライアントデモ,ローカル開発に便利です. サンドボックスのキーがプロドキーとは異なります.

DocuSignやYousignから移行する

DocuSign や Yousign の統合を既に持っている場合は,API マッピングは直接的なものです:エンベロープ →エンベロープ,受信者 →受信者,ステータス webhooks →ステータス webhooks. 移行ガイドではエンドポイントごとに等価性を文書化しています. 完全な移行には1〜3日かかります. 内部ラッパーを使用している場合ははるかに短くなります.

疑問のフェア API

APIの限界は?

標準では1分間に1000件のリクエストがあり,高利用 (工場,マルチテイナープラットフォーム) の場合,要求に応じて増加する.各回答のX-RateLimit-Remainingヘッダは残ったクォータを表示する.超えると,APIは Retry-Afterで 429を返します.

APIの値段は?

サンドボックスは無料で無制限です.生産はサインアップで稼働します (AESサインアップは0.40€からボリューム降低で),最低サブスクリプションはありません.エンタープライズプランには強化されたSLA,IPホワイトリスト,専用技術アカウントが含まれています.

ALSってある?

ビジネスとエンタープライズプランでは99.95%のアップタイム (年間最大4時間のダウンタイム) 公共の状況ページ: status.certyneo.com. エンタープライズプランにはSLAの違反の場合は自動的にクレジットがあります.

どんな認証を使っていますか?

Bearer token (APIキー) は Authorization ヘッダに.キーがダッシュボードから回転可能で,即時取り消されます.OAuth (マルチステンダープラットフォーム) 統合では,エンタープライズプランでOAuth 2.0 クライアント クレデントリを提供します.

ウェブフックのHMAC署名を 確認するには?

Webhook には, payload の HMAC SHA-256 を含む X-Certyneo-Signature ヘッダが含まれる. サーバー側では, HMAC を再計算して,定時比較 (timing-safe comparison) を行う. 公式 SDK は,webhook.verify(payload,署名,秘密) を介して自動的にそれを行う.

SDKはオープンソースですか?

バイナリは @certyneo / certyneo のネームスペースで npm,PyPI,RubyGems に公開されています.

登録なしでテストしてもいいですか?

そうです.APIドキュメントのインタラクティブな例: /developers/playground を使って. キー不要で共有されたサンドボックスインスタンスの要求をします. 深刻な用途では,無料の開発者アカウントを作成してください (無制限サンドボックス).

電子署名を組み込む準備はできていますか?

無制限の無料サンドボックス 完全なドキュメント 公式SDK

文書を読む Certyneoの開発者と話をする