Fara beint að aðalefni
Certyneo
API REST eIDAS

Rafræn undirritunarforrit fyrir verktaka

Bættu eIDAS inn í forritið þitt á nokkrum klukkustundum. REST, traust netföng, Node/Python/Ruby SDK, ótakmarkaður ókeypis sandkassi.

Búðu til verktaka API skjalagerð

Frítt sandkassi · 99,95% upptíma · EU rík hýsing

REST + OpenAPI 3.1

Spárætar endir, hreint JSON, venjulegur HTTP kóði.

Traust netföng

Sjálfvirkur endurrannsókn með framsækni baksögn, undirskrift HMAC SHA-256, fundarlegt atburðarheft.

E-Natif eIDAS samræmi

AES, AES-Q og QES undirritun í boði í gegnum API flag.

Vöndun < 200 ms

API hýst í Strasbourg (ESB), p95 < 200 ms frá Evrópu.

Upphaf í fimm mínútur.

Búðu til fyrsta umslag þitt með einni HTTP fyrirspurn.

cURL Að búa til umslag
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"
  }'

Ein POST fyrirspurn er nóg til að búa til umslag, bæta við skjali, undirritara og webhook URL. API skilar sign_url tilbúinn til að deila.

Stjórnmálastjóri 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 veitir fullri ritgerð, sjálfvirka villustýringu með endurprófun og fljótandi umbúðarframleiðanda.

Vefsjónir bregðast við í rauntíma

Sex atburðir (hjúp.senda, skoðað, skrifað undir, lokið, hafnað, gengið út) með HMAC-fyrirritun sem hægt er að athuga og prófa aftur sjálfkrafa.

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 undirrit á hverri greiðslugjöf staðfesta á netþjóninum.
  • Sjálfvirkur endurpróf ef það mistekst: 5 tilraunir á 24 klst. með framsækjandi baksókn.
  • Atburðarlogg sem hægt er að skoða úr stjórnborðinu: sjá hverja tilraun, HTTP stöðu sem skilað var, líkamann.
  • URL vefmótar sem hægt er að stilla yfir eða yfir í verkefninu.

Af hverju sérstakt notkunartæki fyrir rafræna undirritun?

Það er ekki óþarft að innleiða rafrænt undirskrift í vöruna þína. Þú þarft tryggingar um löglega samræmi (eIDAS), tæknilegt traust (veffföng sem koma í raun og veru) og gagnaveldi (evrópsk hýsing til að koma í veg fyrir skýjalaga). Certyneo API nær yfir allt þrennt.

Hún er hönnuð af og fyrir verktaka og fylgir nútíma REST samningum: síðu- byggð síðu, idempotency lyklar, útgáfu eftir URL, OpenAPI 3.1 til að búa til viðskiptavini sjálfkrafa.

EIDAS samræmi útskýrt fyrir verktaka

EIDAS reglugerðin skilgreinir þrjú undirritunarstig: einfalt (SES), háþróað (AES) og hæft (QES). Certyneo API gerir kleift að velja undirritunarstig eftir umslagi með því að nota felt `signature_level`. Sjálfgefið gildi er AES (nóg fyrir 95% B2B-tilvik). QES er í boði fyrir gögn sem þurfa ströng lögleg jafngildi við handritan undirritun (notariska gögn, opinber kaup).

AES krefst tæknilega sterkrar sannprófunar á undirritara (OTP með SMS sjálfgefið, KYC myndband valfrjálst) og tímalagða endurskoðunarbrautar. QES bætir við hæft vottorð frá EU hæfum TSP. Allt þetta er stjórnað af API þú hringir í endasvæðið, við sjáum um restina.

Mælt er með samþættingararkitektúr

Algengasta samsetningarmynstrið er þetta:

  • Bakhliðið þitt kallar á POST /v1/envelopes til að búa til umslag og fær sign_url til að sýna notandanum.
  • Þú sendir notandann aftur á sign_url eða bættir inn í iframe (með vörumerki þínu í gegnum Pro áætlun).
  • Þegar undirritun er lokið kallar Certyneo á vefmiðilinn þinn með viðburðinum envelope.completed.
  • Þú uppfærir gagnagrunninn þinn og tilkynnir notandanum (e-mail, innri app, osfrv.).

Frítt sandkassi ótakmarkað

Sandbox umhverfið er ókeypis og ótakmarkað. Allir framleiðslu eiginleikar eru í boði, nema undirritun hefur ekki löglegt gildi (PDF er merkt SANDBOX). Hentar fyrir sjálfvirka prófun, viðskiptavinur sýningar, staðbundna þróun. Sandbox lyklar eru aðskilin frá prod lyklar, algjör einangrun á milli þeirra.

Flóa frá DocuSign eða Yousign

Ef þú ert þegar með DocuSign eða Yousign samþættingu er kortlagning API beint: umbúðir → umbúðir, viðtakendur → viðtakendur, stöðu webhooks → stöðu webhooks.

Spurningarnar eru að verða

Hver er takmörk API-sniðganga?

1000 fyrirspurnir á mínútu fyrir sjálfgefið, aukandi eftir eftirspurn fyrir háan notkun (verksmiðjur, fjölþjálfarí).

Hvað kostar API?

Sandkassinn er ókeypis og ótakmarkaður. Framleiðslan er á borgun við undirritun (frá 0,40 € AES-undirritun með magnshækkun), án lágmarksáskriftar.

Er einhver ALS?

99.95% upptíma á viðskipta- og fyrirtækjaskipulagi (hámark 4 klst. niðurtíma á ári).

Hvaða staðfestingu notarðu?

Í upphafi var það aðalmálið að setja inn "OAuth" í notendaupptöku.

Hvernig kannar maður HMAC undirskrift á netfangi?

Hver vefmótur inniheldur X-Certyneo-Signature heitara sem inniheldur HMAC SHA-256 af greiðslugjaldinu, sem er skrifað undir með leyndu vefmótinum þínum.

Eru SDK-ið opinn uppspretta?

Já. Node, Python og Ruby SDK eru á GitHub undir MIT leyfi. Þú getur forker, stuðlað eða bara endurskoðað þá. Tvíbúnaðar eru gefin út á npm, PyPI og RubyGems undir nafnasvæði @certyneo / certyneo.

Má ég prófa án skráningar?

Já, með gagnvirkum dæmi í API skjal: /developers/playground. Fyrirspurnir þar snúast gegn sameiginlegum sandkassa fyrirmynd, án lykils. Fyrir alvarlega notkun, stofnaðu ókeypis verktaka reikning (ótakmarkaður sandkassi).

Eruð þið tilbúin til að setja inn rafræna undirskrift?

Ótakmarkaður ókeypis sandkassi, fullur skjalasafn, opinbera SDK.

Lestu skjalin Talaðu við Certyneo verktaka