API REST — eIDAS

ለሰሞ-አሪት ፌደሪ-ገ-ሳዊ API

eIDAS ለ-ፌደሪ ገ-ሳዊ በእርስዎ ትግበራ ውስጥ ጥቂት ጊዜ ውስጥ። REST ፤ አስተማራት webhooks ፤ SDK Node/Python/Ruby ፤ ነጻ ሙሉ sandbox።

አንድ ባለሙያ ክፍል ሪጀስትር API ሰነድ

ነጻ sandbox · 99.95 % uptime · ከ EU ላይ ዋና ተከላ

REST + OpenAPI 3.1

ጽንሰ-ሐሳብ endpoints ፤ ንጹህ JSON ፤ መደበኛ HTTP ኮዶች። ስሌት OpenAPI 3.1 ሊያወርድ ይችላሉ ብቻዎን ሰነድ ለመጠየቅ።

Webhooks አስተማራት

ራሱ ሞከር በ exponential backoff ፤ HMAC SHA-256 ስሌት ፤ ሪጀስትር ሰነድ ምልከታ። Polling ሞከር ላ።

eIDAS ግዛት ሓድ

ስሌት AES, AES-Q እና QES በ flag API ተገቢ ። ብቃቶች ምስክር ዓላቅ ሓድ ፤ ውጤታት TSP ብቃቶች EU ።

Latency < 200 ms

API በ Strasbourg (EU) ተከላ ፤ p95 < 200 ms ከ Europe ውስጥ። SLA 99.95 % uptime ፤ ሙሉ ሁኔታ ሓሚስ ብለው።

ለሙሉ 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 ጥያቄ ሸጋጭ ፍጠር፣ ሰነድ ተጨማሪ፣ ስሌት ወፍ እና webhook URL ይበቃ። API ድምጽ sign_url ተመለሰ ጋር ውከራ።

SDK Node.js ይፋዊ

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

SDK Node TypeScript ሙሉ ዓይነት ፣ ራሱ ስህተት ንቁ ከ retry ፣ እና ሸጋጭ ጥንቁቅ ፈጣን ፍጠር። Python እና Ruby ውስጥ ይገኛሉ።

Webhooks — በሮ ጊዜ ምላሽ

ስድስት ሰነድ (envelope.sent, viewed, signed, completed, declined, expired) በ HMAC ስሌት ማረጋገጫ ጋር እና ራሱ retry।

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 ስሌት ለእያንዳንዱ payload — ስሌት በ server ጋር ማረጋገጫ።
ራሱ retry ስህተት ሁኔታ: 5 ሞከር በ 24 ሰዓታት ከ exponential backoff።
ሎጅ ሰነድ ምልከታ ከ dashboard: እያንዳንዱ ሞከር ፣ HTTP ሁኔታ ተመለሰ ፣ body।
Webhook URL ሓሊበ ከ envelope (override) ወይም ሓሊበ በ ፕሮጀክት።

ለምን አንድ API ለ-ፌደሪ ገ-ሳዊ?

ከ-ፌደሪ ገ-ሳዊ በእርስዎ ውሳኔ ውስጥ አዛውት አይደለም ። ስለ ሕገ-ወጥ ኃላፊነት (eIDAS) ፣ ቴክኒካዊ አስተማራት (webhooks በእውነተኛ አርሰል) እና ንግግር ሃይሳ (ከ Cloud Act መራቅ ለ EU ተከላ) ላይ ያስፈልግዎታል ። Certyneo API ሦስቱን ሚድ।

ከሰሞ-አሪት ለ እና ወደ ሰሞ-አሪት ፣ ይህ ዘመናዊ REST ለ-ኃላፊነት ተከትል: ጁምላ cursor-based ፣ idempotency ቁልፍ ፣ ስሪት በ URL ፣ OpenAPI 3.1 ጣቢያ ሰነድ ራሱ ። SOAP አይደለም ፣ XML አይደለም ፣ ጥቂት ያልታለመ።

eIDAS ለሰሞ-አሪት ሊሸለም

eIDAS ደንብ ሦስት ደረጃ ሕገ-ወጥ ይግለጹ: ቀላል (SES) ፣ ላቀ (AES) እና ብቃቶች (QES) ። Certyneo API ደረጃ ለመረጠ ለ envelope ወደ `signature_level` መስክ። ቅላጭ ዋጋ AES (ብቃቶች 95 % B2B) ። QES ለ actes ብቃቶች ኃላፊነት ሌላ ከ ሙሉ ናንሙ ሕገ-ወጥ (notarial actes ፣ ህዝብ ገበያ) ።

ቴክኒካዊ ጎን ፣ AES ሰጨ ምስክር (SMS OTP ብቃቶች ፣ ቪዲዮ KYC ኢ ተራ) እና horodated ምስክር ወሳኞች። QES ብቃቶች ሰርተፊኬት ወደ qualifié TSP EU ተጨመረ። ይህ ሙሉ ዋና API — አሉ endpoint ጠርተው ፣ ከ ሕገ-ወጥ።

ሓላፊነት ውስጥ የሰሞ-አሪት ሓሳብ

ሳይሊ ወተወራ ዓይነት ብዙ ወቅታት ይከተል :

የእርስዎ backend POST /v1/envelopes ይጠራል envelope ለመፍጠር እና sign_url ይቀበላል ወደ ተጠቃሚው ለማቅረብ።
ተጠቃሚውን ወደ sign_url ሪዳይሬክት ያደርጋሉ ወይም iframe ውስጥ ያካምፉታል (የእርስዎ branding በ Pro ታቅዶ)።
signature ከተሟላ በኋላ Certyneo የእርስዎ webhook ይጠራል envelope.completed ክስተት ጋር።
የእርስዎ database ያሳደሩ እና ተጠቃሚውን ይገልጻሉ (ኢሜል፣ in-app፣ ወዘተ)።

Sandbox ነጻ ላልተገደበ

sandbox አካባቢ ነጻ እና ላልተገደበ። ሁሉም የምርት ባህሪዎች አሉ፣ ነገር ግን ስብሰባዎች ምንም ህጋዊ ዋጋ የላቸውም (PDF SANDBOX ተቆይቷል)። ለራስ ሙከራ፣ ለደንበኛ ስሪ፣ ለአካባቢ ልማት። sandbox ቁልፎች prod ቁልፎች ከተለያዩ፣ ሙሉ ማግለል በሁለቱ መካከል።

ከ DocuSign ወይም Yousign ሚግሬট ያድርጉ

ቀድሞ DocuSign ወይም Yousign ውህደት ካለዎት፣ API mapping ቀጥተኛ : envelopes → envelopes, recipients → recipients, status webhooks → status webhooks. የእኛ የሚግሬሽን መመሪያ endpoint by endpoint equivalences ሰነዶች። ለሙሉ ሚግሬሽን 1 እስከ 3 ቀን ይቆጠሩ፣ ውስጣዊ wrapper ከተጠቀሙ በጣም ያነሰ።

በተደጋጋሚ ጠየቅ የሚሆሉ ጥያቄዎች — API

የAPI rate limit ምንድነው?

ከአንድ ደቂቃ 1,000 ጥያቄዎች በነባሪነት፣ ከፍ ያሉ ጥቅሞች (factories, multi-tenant platforms) ለመጠየቅ። X-RateLimit-Remaining ራስ በእያንዳንዱ ምላሽ ላይ ቀሪ quota ያሳያል። ከመንገዱ ሲበልጡ፣ API 429 ከ Retry-After ይመልሳል።

API ስንት ያስወጣል?

sandbox ነጻ እና ላልተገደበ። አምራቹ በ signature ክፍያ ይሠራል (ከ 0,40 € AES signature ጀምሮ volume degressivity ጋር)፣ ምንም አነስተኛ መታወቂያ ባይ። ኤንተርፕራይዝ ታቅዶ ኃይለኛ SLA፣ IP whitelisting እና ጥገና ቴክኒክ ያካቻል።

SLA አለ?

99,95% uptime Business እና Enterprise ታቅዶ ላይ (አመት በ 4 ሰዓት ከፍተኛ downtime)። በሕዜ ዓለም ሁኔታ ገጽ ከ incidents ታሪክ : status.certyneo.com. ኤንተርፕራይዝ ታቅዶ SLA ያልሆነ ወቅት ላይ አስገራሚ ክሬዲት ይጨምራል።

ምን ሕጋዊ ሙከራ ትጠቀማላችሁ?

Bearer token (API ቁልፍ) በ Authorization ሀረግ ውስጥ። ቁልፎች ከ dashboard ሊቃኙ ይችላሉ፣ ወዲያውኑ ተብ ሰር ሊሆን ይችላል። OAuth integrations (multi-tenant platform)፣ የ OAuth 2.0 Client Credentials ኤንተርፕራይዝ ታቅዶ ይሰጣሉ።

webhook ሪቻ ሕጋዊነት እንዴት ተረጋግጠዋል?

እያንዳንዱ webhook X-Certyneo-Signature ሀረግ ያካትታል HMAC SHA-256 payload ሊይ ዋጋ ያላት፣ የእርስዎ webhook secret ሊይ ተፈርሙ። አገልግሎት ጎን ላይ HMAC ድጋገሙ እና ቦታ ቋሚ ውስጥ ለመወዳደር (timing-safe comparison)። ኦፊሴላዊ SDK ወዲያውኑ ይሠራል webhook.verify(payload, signature, secret)።

SDK ናቸው ክፍት ምንጭ?

አይ። Node, Python እና Ruby SDK GitHub ላይ ናቸው MIT ወሰን ሕግ ወሰን. ፎርክ፣ መበርከት ወይም አጣራ ይችላሉ። Binaries npm, PyPI እና RubyGems ላይ @certyneo / certyneo namespace ሥር ታተሙ።

መመዝገብ ሳይሆን ይሞከራላቸው?

አይ, በ API documentation ተጨማሪ ተግባር ይህ በ /developers/playground. ጥያቄዎች በ ክፍልፍል sandbox ደረጃ ላይ ይሰሩ, ቁልፍ ሳያስፈልግ. ለ ከባድ ጥቅም, ነጻ ገንዘብ ብቃት ሂሳብ ይፍጠሩ (sandbox ላልተገደበ).:

ኤሌክትሮኒክ ስብሰባ ለማዋሀድ ዝግጁ?

Sandbox ነጻ ላልተገደበ, ሙሉ ሰነድ, ኦፊሴላዊ SDK. አሁን ይጀምሩ.

ሰነድ ያንብቡ Certyneo ገንዘብ ተናጋሪ ጋር ይነግሩ