Dokumentation för API-funktioner
POST CRM/Contact/{customerId}/TrialMatch/{marketplaceNumber} Provmatchning mot marknadsplats Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kundid string Krävs
marketplaceNumber integer Krävs
Body Parameters Matchningskriterie TrialMatchedMarketPlaceCriteria
NamnBeskrivningTypInformation
EstateType Objekttyp MatchEstateType

Coordinate Koordinat WGS84. Coordinate

Price Pris decimal number

MonthlyFee Månadsavgift (tas bara hänsyn till på lägenhet) decimal number

Rooms Antal rum integer

LivingArea Boarea(kvm) decimal number

NewProduction Nyproduktion boolean

Address MatchAddress

Request Formats

{
  "estateType": "House",
  "coordinate": {
    "longitude": 1.1,
    "latitude": 2.1
  },
  "price": 1.1,
  "monthlyFee": 1.1,
  "rooms": 1,
  "livingArea": 1.1,
  "newProduction": true,
  "address": {
    "streetAddress": "sample string 1",
    "zipcode": "sample string 2",
    "city": "sample string 3"
  }
}
<TrialMatchedMarketPlaceCriteria xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.Contact.Crm">
  <Address>
    <City>sample string 3</City>
    <StreetAddress>sample string 1</StreetAddress>
    <Zipcode>sample string 2</Zipcode>
  </Address>
  <Coordinate>
    <Latitude>2.1</Latitude>
    <Longitude>1.1</Longitude>
  </Coordinate>
  <EstateType>House</EstateType>
  <LivingArea>1.1</LivingArea>
  <MonthlyFee>1.1</MonthlyFee>
  <NewProduction>true</NewProduction>
  <Price>1.1</Price>
  <Rooms>1</Rooms>
</TrialMatchedMarketPlaceCriteria>
Response Information Resource Description Provmatchning mot marknadsplats MatchContacts
NamnBeskrivningTypInformation
Count Antal integer

Kodexempel

curl "https://connect.maklare.vitec.net/CRM/Contact/StringValue/TrialMatch/0" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"estateType\":0,\"coordinate\":{\"longitude\":0.0,\"latitude\":0.0},\"price\":0.0}
            

$URL = "https://connect.maklare.vitec.net/CRM/Contact/StringValue/TrialMatch/0"
$data = "{`"estateType`":0,`"coordinate`":{`"longitude`":0.0,`"latitude`":0.0},`"price`":0.0}"
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 = "{\"estateType\":0,\"coordinate\":{\"longitude\":0.0,\"latitude\":0.0},\"price\":0.0}";
using (var response = await HttpClientInstance.PostAsync("CRM/Contact/StringValue/TrialMatch/0", 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 count = result.count.Value;
    // TODO: Gör något med resultatet
}

$URL = "https://connect.maklare.vitec.net/CRM/Contact/StringValue/TrialMatch/0";

$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 = "{\"estateType\":0,\"coordinate\":{\"longitude\":0.0,\"latitude\":0.0},\"price\":0.0}";
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["count"];
// TODO: Gör något med resultatet
Testformulär Text input
Response Formats
{
  "count": 1
}
<MatchContacts xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models.Estate">
  <Count>1</Count>
</MatchContacts>