Dokumentation för API-funktioner
POST Service/Order/Token/{customerId} Hämta ut en ticket för ett beställningstoken Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kund-id string Krävs
Body Parameters Token OrderToken
NamnBeskrivningTypInformation
Data Token data som ni fått som inparameter till beställningen string

Request Formats

{
  "data": "sample string 1"
}
<OrderToken xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.Order">
  <Data>sample string 1</Data>
</OrderToken>
Response Information Resource Description Hämta ut en ticket för ett beställningstoken OrderTicket
NamnBeskrivningTypInformation
OrderId Id på beställningen string

UserId Inloggad användare string

OrderUserId Användaren som är handläggare på bostaden och som äger beställningen string

TargetId Id på bostaden som beställningen gäller string

TargetType Typen av bostad som beställningen gäller string

TenantId Kund-id för hela kundens miljö, alla kunder har detta string

ChainId Kedje-id för kunden string

CustomerId Kund-id, kontoret som äger beställningen string

HasExpired Om tokenet har gått ut och inte längre går att använda boolean

Kodexempel

curl "https://connect.maklare.vitec.net/Service/Order/Token/StringValue" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"data\":\"StringValue\"}
            

$URL = "https://connect.maklare.vitec.net/Service/Order/Token/StringValue"
$data = "{`"data`":`"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 = "{\"data\":\"StringValue\"}";
using (var response = await HttpClientInstance.PostAsync("Service/Order/Token/StringValue", 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 orderTicketHasExpired = result.orderTicketHasExpired.Value;
    // TODO: Gör något med resultatet
}

$URL = "https://connect.maklare.vitec.net/Service/Order/Token/StringValue";

$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 = "{\"data\":\"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["orderTicketHasExpired"];
// TODO: Gör något med resultatet
Testformulär Text input
Response Formats
{
  "orderId": "sample string 1",
  "userId": "sample string 2",
  "orderUserId": "sample string 3",
  "targetId": "sample string 4",
  "targetType": "sample string 5",
  "tenantId": "sample string 6",
  "chainId": "sample string 7",
  "customerId": "sample string 8",
  "hasExpired": true
}
<OrderTicket xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.Order">
  <ChainId>sample string 7</ChainId>
  <CustomerId>sample string 8</CustomerId>
  <HasExpired>true</HasExpired>
  <OrderId>sample string 1</OrderId>
  <OrderUserId>sample string 3</OrderUserId>
  <TargetId>sample string 4</TargetId>
  <TargetType>sample string 5</TargetType>
  <TenantId>sample string 6</TenantId>
  <UserId>sample string 2</UserId>
</OrderTicket>