Dokumentation för API-funktioner
GET BusinessIntelligence/RealtorStatistics Hämtar information för en mäklare kopplad till ett eller flera kontor. Går även att selektera på datumintervall. Ersatt av CommissionUserReport/{customerId} Request Information URI Parameters
NamnBeskrivningTypInformation
licenseId Kund-id (kontor eller grupp) string Krävs
dateFrom Datum från date

dateTo Datum till date

assignment Uppdragstyp AssignmentType

Response Information Resource Description Hämtar beslutstödsstatistik för mäklare. Man kan hämta statistik för mäklare på ett enskilt kontor eller en grupp. Genom att ange ett datumintervall hämtar man enbart statistik från det givna intervallet. Collection of RealtorStatisticsSummary
NamnBeskrivningTypInformation
RealtorId Id string

Name Namn string

Commission Provision decimal number

TotalSales Summa försäljning decimal number

CommissionPercentage Provision i procent av försäljning decimal number

AverageCommission Medelprovision decimal number

AttemptedIntakes Antal intagsförsök integer

Sold Antal sålda bostäder integer

Kodexempel

curl "https://connect.maklare.vitec.net/BusinessIntelligence/RealtorStatistics?licenseId=StringValue&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&assignment=0" -X GET -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" 
            

$URL = "https://connect.maklare.vitec.net/BusinessIntelligence/RealtorStatistics?licenseId=StringValue&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&assignment=0"
Invoke-WebRequest -Uri $URL -Method GET -Headers @{"authorization" = "basic {Base64 kodad användarnamn och lösenord}"} 
                

// 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}")
//     }
// }
using (var response = await HttpClientInstance.GetAsync("BusinessIntelligence/RealtorStatistics?licenseId=StringValue&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&assignment=0")) {
    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 firstInArray = result[0];
    var realtorId = firstInArray.realtorId.Value;
    // TODO: Gör något med resultatet
}

$URL = "https://connect.maklare.vitec.net/BusinessIntelligence/RealtorStatistics?licenseId=StringValue&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&assignment=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);

$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
}

$first = $result[0];
$field_on_result = $first["realtorId"];
// TODO: Gör något med resultatet
Testformulär Text input
Response Formats
[
  {
    "realtorId": "sample string 1",
    "name": "sample string 2",
    "commission": 3.1,
    "totalSales": 4.1,
    "commissionPercentage": 5.1,
    "averageCommission": 6.1,
    "attemptedIntakes": 7,
    "sold": 8
  },
  {
    "realtorId": "sample string 1",
    "name": "sample string 2",
    "commission": 3.1,
    "totalSales": 4.1,
    "commissionPercentage": 5.1,
    "averageCommission": 6.1,
    "attemptedIntakes": 7,
    "sold": 8
  }
]
<ArrayOfRealtorStatisticsSummary xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Connect.Models.BusinessIntelligence">
  <RealtorStatisticsSummary>
    <AttemptedIntakes>7</AttemptedIntakes>
    <AverageCommission>6.1</AverageCommission>
    <Commission>3.1</Commission>
    <CommissionPercentage>5.1</CommissionPercentage>
    <Name>sample string 2</Name>
    <Sold>8</Sold>
    <TotalSales>4.1</TotalSales>
    <RealtorId>sample string 1</RealtorId>
  </RealtorStatisticsSummary>
  <RealtorStatisticsSummary>
    <AttemptedIntakes>7</AttemptedIntakes>
    <AverageCommission>6.1</AverageCommission>
    <Commission>3.1</Commission>
    <CommissionPercentage>5.1</CommissionPercentage>
    <Name>sample string 2</Name>
    <Sold>8</Sold>
    <TotalSales>4.1</TotalSales>
    <RealtorId>sample string 1</RealtorId>
  </RealtorStatisticsSummary>
</ArrayOfRealtorStatisticsSummary>