API Dokumentation

Integrera Evansia direkt i era befintliga arbetsflöden.

Introduktion

Vårt API är byggt på REST-principer och använder JSON för all kommunikation. Ni kan använda API:et för att skapa förfrågningar, hämta status och hantera signerade dokument automatiskt.

Autentisering

Evansia använder en säker tvåstegs-autentisering. Först växlar du din hemliga API-nyckel mot en temporär Bearer-token, som sedan används för att auktorisera dina anrop.

POST/v1/auth/token

Generera en Bearer-token med din Client ID och Secret Key.

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_SECRET_KEY"
}

Svar:

{
  "access_token": "eyJhbG...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Använd din Access Token i alla efterföljande anrop:

Authorization: Bearer YOUR_ACCESS_TOKEN

Endpoints

POST/v1/requests

Skapa en ny signeringsförfrågan. Observera: En dokumentbilaga är obligatorisk.

Content-Type: multipart/form-data

file: [BINARY_DATA]
json: {
  "title": "Samarbetsavtal 2026",
  "request_type": "agreement",
  "signing_method": "bankid",
  "is_gated": true,
  "signers": [
    { "full_name": "Anna Andersson", "email": "anna@partner.se" }
  ]
}

GET/v1/requests/{id}

Hämta status för förfrågan och se vilka parter som har signerat.

Webhooks

Evansia skickar POST-meddelanden till din konfigurerade webhook-URL när viktiga händelser sker, såsom signer.signed eller request.approved (när alla parter signerat).

Begränsningar & Fel

Anropsbegränsningar

Token-generering10 / min
Skapa förfrågan60 / min
Hämta status300 / min

Felkoder

401Ogiltig token eller secret key.
413Filen är för stor (Max 50MB).
429Rate limit har uppnåtts.

Behöver du hjälp med integrationen? Kontakta vår utvecklarsupport påapi@evansia.se