{ "socialNumber": "sample string 1" }
Dokumentation för API-funktioner
POST Authenticate/BankId/{customerId}/Initiate
Initiering av BankId autentisering.
Request Information
URI Parameters
Body Parameters
InitiateData
Response Information
Resource Description
Initiering av BankId autentisering.
InitateResponse
Kodexempel
Testformulär
Text input
Response Formats
Namn | Beskrivning | Typ | Information |
customerId | Kundid | string |
Krävs |
Namn | Beskrivning | Typ | Information |
SocialNumber | Tolvsiffrigt personnummer | string |
Tolvsiffrigt personnummer krävs |
Request Formats
<InitiateData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Authenticate.BankId"> <SocialNumber>sample string 1</SocialNumber> </InitiateData>
Namn | Beskrivning | Typ | Information |
Reference | Referensnummer | string |
curl "https://connect.maklare.vitec.net/Authenticate/BankId/StringValue/Initiate" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"socialNumber\":\"StringValue\"}
$URL = "https://connect.maklare.vitec.net/Authenticate/BankId/StringValue/Initiate"
$data = "{`"socialNumber`":`"StringValue`"}"
Invoke-WebRequest -Uri $URL -Method POST -Headers @{"Content-Type" = "application/json"; "authorization" = "basic {Base64 kodad användarnamn och lösenord}"} -Body $data
// HttpClientInstance ska deklareras som en singleton
// public static readonly HttpClient HttpClientInstance = new HttpClient {
// BaseAddress = new Uri("https://connect.maklare.vitec.net"),
// DefaultRequestHeaders = {
// Authorization = new AuthenticationHeaderValue("Basic", "{Base64 kodad användarnamn och lösenord}")
// }
// }
var json = "{\"socialNumber\":\"StringValue\"}";
using (var response = await HttpClientInstance.PostAsync("Authenticate/BankId/StringValue/Initiate", new StringContent(json, Encoding.UTF8, "application/json"))) {
if (response.StatusCode == HttpStatusCode.Unauthorized) {
// Authorization headern är inte korrekt
}
if (response.StatusCode == HttpStatusCode.Forbidden) {
// Begärt data som det saknas åtkomst till
}
if (response.StatusCode == HttpStatusCode.InternalServerError) {
// Oväntat fel, kontakta Vitec
}
if (response.StatusCode == HttpStatusCode.BadRequest) {
var json = await response.Content.ReadAsStringAsync();
var result = JsonConvert.DeserializeObject<dynamic>(json);
// Hantera valideringsfel, presenteras i resultatet
}
var json = await response.Content.ReadAsStringAsync();
// JsonConvert finns i biblioteket Newtonsoft.Json
var result = JsonConvert.DeserializeObject<dynamic>(json);
var reference = result.reference.Value ;
// TODO: Gör något med resultatet
}
$URL = "https://connect.maklare.vitec.net/Authenticate/BankId/StringValue/Initiate";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERNAME, "{Användarnamn}");
curl_setopt($ch, CURLOPT_PASSWORD, "{Lösenord}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $URL);
$data = "{\"socialNumber\":\"StringValue\"}";
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($data)
));
$result = curl_exec($ch);
if (curl_errno($ch)) {
die(curl_getinfo($ch));
}
$info = curl_getinfo($ch);
curl_close($ch);
$http_code = $info["http_code"];
if ($http_code == 401) {
// Användarnamnet eller lösenordet är felaktigt
}
if ($http_code == 403) {
// Begärt data som det saknas åtkomst till
}
if ($http_code == 500) {
// Oväntat fel, kontakta Vitec
}
if ($http_code == 400) {
$json = json_decode($result, true);
// Hantera valideringsfel, presenteras i $json
}
$field_on_result = $result["reference"];
// TODO: Gör något med resultatet
Resultat av begäran
{ "reference": "sample string 1" }
<InitateResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Authenticate.BankId"> <Reference>sample string 1</Reference> </InitateResponse>