Utvecklare

E-signering från er egen kod.

Ett REST-API för att skapa ärenden, skicka dem, hämta det förseglade dokumentet och få besked när någon signerat. Beskrivet här som det byggs; specifikationen publiceras när API:et släpps.

REST under /api/v1
Webhooks med HMAC
Sandlåda utan kostnad

KommerAPI:et och OpenAPI-specifikationen släpps i ett kommande steg. Sidan beskriver det som planeras.

Skapa ett ärende

curl https://sign.asamla.se/api/v1/cases \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: 7c1f3a2e-…" \
  -F "document=@konsultavtal.pdf" \
  -F 'parties=[{"name":"Maria Johansson","email":"maria@nordvik.se","role":"signer"}]' \
  -F "deadlineAt=2026-10-31" \
  -F "externalRef=AVTAL-2026-114"

Resurser

Allt finns under https://sign.asamla.se/api/v1. Ett ärende är ett dokument med sina parter; allt annat hänger på det.

POST/casesSkapa ett ärende från en PDF eller en mall: parter, roller, ordning, deadline, meddelande, externalRef och metadata.
POST/cases/{id}/sendSkicka ärendet. Det är här ett ärende dras från saldot.
GET/casesLista ärenden, filtrerat på status och externalRef.
GET/cases/{id}Ett ärende med sina parter och deras status.
GET/cases/{id}/eventsÄrendets historik: öppnat, granskat, signerat, avböjt, förseglat.
GET/cases/{id}/documentDokumentet, original eller förseglat (kind=original|sealed).
POST/cases/{id}/parties/{pid}/linkEn inbäddad signeringsadress, för att signera inne på er egen sida.
POST/cases/{id}/cancelÅterkalla ett skickat ärende.
DELETE/cases/{id}Ta bort ett utkast, eller ett skickat ärende som ingen agerat på.

Webhooks

Ni anger en adress och får ett anrop per händelse. Varje anrop är HMAC-signerat med en tidsstämpel, så ni kan avvisa både förfalskningar och återuppspelningar. Misslyckade leveranser görs om med stigande väntetid, och varje försök syns i en leveranslogg i ert konto.

case.sent
party.viewed
party.approved
party.signed
party.declined
case.completed
case.expired

Autentisering

Varje konto skapar sina egna API-nycklar under Utvecklare i Asamla Sign. En nyckel har behörigheter (cases:read, cases:write) och är antingen test eller live. Nycklarna lagras hashade hos oss, på samma sätt som signeringslänkarnas hemligheter, så en läcka från vår sida ger ingen användbar nyckel.

En testnyckel arbetar i sandlådan: ärenden skapas och kan signeras på riktigt, men inget dras från saldot och förseglingen stämplas TEST. OAuth 2.1 för partnerappar som agerar för flera kunders räkning är planerat efter nycklarna.

Idempotens och gränser

Varje POST tar en Idempotency-Key. Skickar ni samma anrop två gånger, för att ett nätverk hickade, får ni samma svar och ett ärende, inte två.

Anropen är begränsade per nyckel. Gränserna står i svaret, så ni kan backa i tid i stället för att gissa.

Inbäddad signering

Vill ni att kunden signerar inne på er egen sida, utan att lämna den, ber ni om en inbäddad adress för en part och visar den i en iframe. Allt som gäller för länken i mejlet gäller också här: vem, när, hur och fingeravtrycket sparas i beviset.

OpenAPI och exempel

Specifikationen publiceras här i OpenAPI 3-format samtidigt som API:et, med exempel i curl, Node och Python. Vill ni vara med och prova innan dess, hör av er så får ni en testnyckel när sandlådan öppnar.

KommerAPI:et, nycklarna, sandlådan och specifikationen hör till steg 5 i Asamla Signs plan och är inte släppta ännu.

Vill ni integrera innan API:et släpps?

Berätta vad ni bygger så hör vi av oss när sandlådan öppnar.

Kom igång gratis