Kehittäjille
Käynnistä allekirjoituspyyntö suoraan omasta järjestelmästä REST-rajapinnan kautta, seuraa tilaa webhookeilla, tai upota allekirjoitusnappi omalle sivustolle muutamalla rivillä koodia.
Rajapinta (REST API)
Autentikointi tapahtuu API-avaimella (Authorization: Bearer sk_live_…). Kaikki vastaukset ovat JSON-muotoisia, ja syötteet validoidaan palvelinpuolella. Yksi allekirjoituspyyntö voi sisältää useita asiakirjoja ja allekirjoittajia, ja niiden tilaa voi seurata rajapinnasta tai webhookeista.
Käynnistä allekirjoituspyyntö
curl -X POST https://app.esinetti.fi/api/v1/rounds \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"title": "Hallituksen kokouksen pöytäkirja",
"documents": [{ "name": "poytakirja.pdf", "content_base64": "..." }],
"signers": [{ "name": "Maija Meikäläinen", "email": "maija@esimerkki.fi" }],
"send": true
}'Vastaanota tilapäivitys webhookilla
POST /teidan-jarjestelmanne/webhook
X-eSinetti-Signature: t=1730000000,v1=<hmac>
{
"event": "round.completed",
"data": {
"round_id": "rnd_123",
"documents": [{ "id": "doc_1", "sealed_sha256": "...", "download_url": "..." }]
}
}Upota allekirjoitusnappi omalle sivustolle
<div data-sinetti-round="rnd_123"></div> <script src="https://esinetti.fi/embed/v1/esinetti.js"></script>
Webhookit
Tapahtumat kuten allekirjoituspyynnön lähetys, allekirjoittajan tunnistautuminen ja allekirjoitus, sekä koko pyynnön valmistuminen lähetetään webhookina omaan järjestelmäänne. Jokainen webhook on allekirjoitettu, jotta voitte varmistaa sen tulevan eSinetistä. Webhook-payloadit eivät koskaan sisällä henkilötunnusta tai syntymäaikaa.
Upotus omalle sivustolle
Pieni JavaScript-snippet avaa allekirjoitussivun ponnahdusikkunassa omalta sivustoltanne. Pankkien tunnistautumissivut eivät toimi upotettuna kehyksenä (iframe), joten allekirjoitus tapahtuu aina omassa ikkunassaan – valmistuttuaan ikkuna sulkeutuu ja sivustonne saa siitä tiedon.
Tarkempi dokumentaatio
Koko rajapinnan kuvaus (OpenAPI) löytyy sovelluksen omalta dokumentaatiosivulta, kun sovellus on julkaistu.