Behöver du integrera Freja eID i en app eller på webben? En integration via Freja eID Integration API är:
Driftsäker
Snabb
Enkel
Freja Integration API
Ett driftsäkert, snabbt och enkelt API för att integrera Freja eID
Marknadens enklaste Freja-API - ca 5 minuters integration (Frejas eget API tar ca 100 h att integrera)
Inga virtuella maskiner eller certifikatshantering = inga skenande konsultkostnader
BankSignering är återförsäljare hos Freja eID, vilket innebär att ni enbart behöver ha kontakt med oss
Dedikerad supporttekniker
Driftsäker, snabb och säker hantering av anrop och data
↓ Klicka här för beskrivning av endpoints↓
Behöver ni integrera Freja eID i ert system? Vårt API är enkelt, säkert och mycket snabbt att integrera - en erfaren programmerare bör kunna göra en första autentisering inom 5 minuter, oavsett programmeringsspråk.
API:t har två endpoints: 1) Freja Auth: Används för att autentisera en användare. Du gör ett anrop och får tillbaka en orderreferens, en autostarttoken och en url till en QR-kod. De använder du sedan för att hämta status för signeringen, skapa en länk till Freja-appen eller visa en QR-kod som öppnar Freja-appen.
2) Freja CollectStatus: Används för att hämta status för en autentisering. Om en autentisering är under behandling får du status och en "hintCode" som beskriver var i processen användaren befinner sig. När en autentisering är klar får du personnummer, förnamn, efternamn och fullt namn på personen
Nedan följer exempelkod med förklaringar av vilken data som krävs. Kontakta oss gärna om du vill veta mer!
1) Freja Auth endpoint (POST)
Freja Auth endpoint JSON:
{
"apiUser":"xxx", // String - username given by BankSignering "password" : "yyy", // String - password guid given by BankSignering "companyApiGuid" : "zzz", // String - company guid given by BankSignering
}
Freja Auth endpoint response JSON:
{
"authResponse": {
"Success": true, // Bool - was the authentification with BankSignering successful? "ErrorMessage": null // String - If something went wrong, what went wrong?
}, "apiCallResponse": { // Null if authentification fails
"Success": true, // Bool - was the send successful? "StatusMessage": "Freja authentication initiated", // String - How did the call go? And if something went wrong, what went wrong? "Response": {
"OrderRef": "c1c53baf-9d97-4678-84e2-311c990fad12", // String - The guid to use when getting the sign status later "AutoStartToken": "6a20c02e-fd99-43b8-985d-3fc7b9da1fe3" // String - Use this to forward the user directly to the Freja app. Use the link structure: frejaeid://bindUserToTransaction?transactionReference=[AutoStartToken]&originAppScheme=[RETURNURL] "QrImage": "https://api.banksign.com/frejaqr/3b34k22g-fd99-43b8-985d-3fc7b9da5ht8"
// String - Url to a QR code image. The user scans the QR code with the Freja app to start the autentication
}
}
}
2) Freja CollectStatus endpoint (POST)
Freja CollectStatus endpoint JSON:
{
"apiUser":"xxx", // String - username given by BankSignering "password" : "yyy", // String - password guid given by BankSignering "companyApiGuid" : "zzz", // String - company guid given by BankSignering
"orderRef" : "c1c53baf-9d97-4678-84e2-311c990fad12", // String - the orderRef from the response when posting to the Freja Auth endpoint
}
Freja CollectStatus endpoint response JSON:
{
"authResponse": {
"Success": true, // Bool - was the authentification with BankSignering successful? "ErrorMessage": null // String - If something went wrong, what went wrong?
}, "apiCallResponse": { // Null if authentification fails
"Success": true, // Bool - was the send successful? "StatusMessage": "complete", // String - How did the call go? And if something went wrong, what went wrong? "Response": {
"OrderRef": "c1c53baf-9d97-4678-84e2-311c990fad12", // String - The guid to use when getting the sign status "Status": "complete" // String - The current status of the orderRef: "pending", "failed" or "complete" "HintCode": "null" // String - Hint for pending calls: "outstandingTransaction", "noClient", "started" or "userSign". For failed calls: "expiredTransaction", "certificateErr", "userCancel", "cancelled" or "startFailed". "CompletionData": {
"user": {
"personalNumber": "195511237794", // String - The swedish social security number returned by the Freja eID service "name": "Karl Svensson", // String - User full name "givenName": "Karl", // String - User first name "surname": "Svensson" // String - User surname
}
}
}
}
}
Offertförfrågan
Fyll i dina företagsuppgifter så skickar vi en offert inom 24 h
Vi använder cookies på vår webbplats för att se hur du interagerar med den samt för att kunna särskilja våra driftmiljöer. När du trycker på Godkänn samtycker du till vår användning av cookies.
Läs vår cookiepolicyJag godkänner användande av cookies
