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で利用可能.

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

エンベロープおよび受取人イベント、検証可能な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規則では、署名の水準を3段階（簡易署名（SES）、先進署名（AES）、適格署名（QES））に定義しています。Certyneo APIでは、`signature_level`フィールドを通じてエンベロープごとに水準を選択できます。デフォルト値は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とマークされています) 以外,すべての生産機能が利用できます. 自動テスト,クライアントデモ,ローカル開発に便利です. サンドボックスのキーがプロドキーとは異なります.

コードを書きたくない場合

この API が実行するすべてのことは、フローからコードを 1 行も書かずに操作することもできます：エンベロープを作成し、送信し、署名に反応し、シールされた PDF と監査証跡を取得します。同じ基盤ですが、HTTP クライアントの代わりに視覚的デザイナーがあります。参照 Power AutomateおよびMicrosoft 365統合.

DocuSignやYousignから移行する

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

Adobe Acrobat Sign（旧EchoSign、その後Adobe Sign）から移行していますか？マッピングは同様に直接的です。agreements → envelopes、participants → recipients、webhooks → webhooks。 Certyneo と Adobe Acrobat Sign を比較する →

電子署名 API の価格：サブスクリプションをどこで購入するか？

署名API サブスクリプション購入に際して見積書や発注書は不要です。サンドボックスは無料で無制限、API キーはダッシュボードから生成でき、本番環境の REST API へのアクセスは Standard プラン（月額 19 €）から含まれています。Webhook と SDK が含まれており、署名ごとの追加料金はありません。

Standard — 月額 19 €：月間 100 エンベロープ、REST API + Webhook、10 ユーザー
Business — 月額 39 €：月間 300 エンベロープ、一括送信、ウェブフォーム
Business Pro — 月額 99 €：月間 1,000 エンベロープ、高頻度 API（300 req/分）、ユーザー無制限

適格署名 (QES) は別製品で、行為ごとに請求されます：1 つの署名あたり 9.90 ユーロ、すべてのプラン (無料を含む) で利用可能です。

大量のボリュームまたは契約上の誓約の必要性（SLA、専用 DPA、年間請求）の場合、Enterprise プランは営業チームから購入できます。いずれにせよ、価格は公開されています。ご契約前に比較してください。

疑問のフェア API

APIの限界は?

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

APIの値段は?

サンドボックス（sk_test_ キー）は無料で無制限です。本番環境の REST API へのアクセスは Standard プラン（月額 19 €、月間 100 エンベロップ）から含まれ、その後 Business（月額 39 €）と Business Pro（月額 99 €）で増加するクォータを提供します。適格署名（QES）は個別製品で、1 署名あたり 9.90 € の従量課金です。より大規模な利用または強化された SLA については、営業チームを通じて Enterprise プランの購入をお願いします。

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 を使って. キー不要で共有されたサンドボックスインスタンスの要求をします. 深刻な用途では,無料の開発者アカウントを作成してください (無制限サンドボックス).

EchoSign API（現在の Adobe Acrobat Sign）の価格はいくらですか？

EchoSign は 2011 年に Adobe に買収され、Adobe Sign、その後 Adobe Acrobat Sign に改名されました。API は存在していますが、その価格は公開されておらず、Adobe の営業チームからの企業向け見積書が必要で、通常は年間トランザクション単位での課金です。一方、Certyneo は価格を公開しています。本番環境 API アクセスは Standard プラン（月額 19 €）から含まれ、見積書なしでオンライン購入でき、API を評価してから支払うための無制限の無料サンドボックスを提供します。

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

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

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