Vitec Connect
Dokumentation för API-funktioner
POST BusinessIntelligence/Budget/{customerId}/{officeId}/{userId}/{year}/{month} Uppdaterar budgetuppgifter Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kund-id string Krävs
officeId Unik identifierare på butiken som budgeten avser string Krävs
userId Användar-id på användaren som budgeten avser string Krävs
year År integer Krävs
month Månad integer Krävs
Body Parameters Budget RealtorBudget
NamnBeskrivningTypInformation
Commission Provision (exkl.moms) max 10 000 000kr integer

Estates Bostäder Estates

SaleMeetings Möten SaleMeetings

Request Formats

{
  "commission": 1,
  "estates": {
    "sold": 1,
    "registered": 1
  },
  "saleMeetings": {
    "total": 1,
    "ownBooked": 1
  }
}

<RealtorBudget xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Budget">
  <Commission>1</Commission>
  <Estates>
    <Registered>1</Registered>
    <Sold>1</Sold>
  </Estates>
  <SaleMeetings>
    <OwnBooked>1</OwnBooked>
    <Total>1</Total>
  </SaleMeetings>
</RealtorBudget>
Response Information Resource Description Uppdaterar budgetuppgifter

Kodexempel 

curl "https://connect.maklare.vitec.net/BusinessIntelligence/Budget/StringValue/StringValue/StringValue/0/0" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"commission\":0,\"estates\":{\"sold\":0,\"registered\":0},\"saleMeetings\":{\"total\":0,\"ownBooked\":0}}
            

$URL = "https://connect.maklare.vitec.net/BusinessIntelligence/Budget/StringValue/StringValue/StringValue/0/0"
$data = "{`"commission`":0,`"estates`":{`"sold`":0,`"registered`":0},`"saleMeetings`":{`"total`":0,`"ownBooked`":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 = "{\"commission\":0,\"estates\":{\"sold\":0,\"registered\":0},\"saleMeetings\":{\"total\":0,\"ownBooked\":0}}";
using (var response = await HttpClientInstance.PostAsync("BusinessIntelligence/Budget/StringValue/StringValue/StringValue/0/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
    }
}


$URL = "https://connect.maklare.vitec.net/BusinessIntelligence/Budget/StringValue/StringValue/StringValue/0/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 = "{\"commission\":0,\"estates\":{\"sold\":0,\"registered\":0},\"saleMeetings\":{\"total\":0,\"ownBooked\":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
}
Testformulär Text input