Express Connect

Dokumentation för API-funktioner

GET Meeting/{customerId}/{id} Hämtar ett bokat möte Request Information URI Parameters

Namn	Beskrivning	Typ	Information
customerId	Kund-id	string	Krävs
id	Mötets id	string	Krävs

Response Information Resource Description Hämtar ett bokat möte Meeting

Namn	Beskrivning	Typ	Information
Id	Mötesid	string
ContactId	Kontakt id	string
ContactName	Kontaktnamn	string
Address	Adress	Address
TelePhone	Telefonnummer bostad	string
CellPhone	Telefonnummer	string
MeetingDate	Mötesdatum	date
Type	Mötestyp	MeetingType
BrokerId	Mäklarens id	string
BrokerName	Mäklarens namn	string
BookedById	Bokarens id	string
BookedByName	Bokarens name	string
BookedDate	Bokningsdatum	date
SignatureDate	Uppdragsdatum	date
EstateStatus	Objektets status	Status
CommissionWithoutTaxes	Provision ex.moms	decimal number
CommissionSource	Intagskälla (Kontakttyp) Ska inte användas längre. Använd AssignmentSource istället	string
AssignmentSource	Intagskälla (Kontakttyp)	AssignmentSource
CancelledBy	Avbokad av (Mäklare, Kund)	string
AgreementDate	Försäljning = Kontraktsdatum, Värdering = Värderingsdag, Skrivning = Datum för skrivuppdrag	date
CommissionType	Uppdragstyp	CommissionType
AccessDate	Tillträdesdatum	date
EstateId	Objektets id	string

Kodexempel

CURL kommando
Powershell
.NET c#
PHP


curl "https://connect.maklare.vitec.net/Meeting/StringValue/StringValue" -X GET -H "Authorization: basic {Base64 kodad användarnamn och lösenord}"


$URL = "https://connect.maklare.vitec.net/Meeting/StringValue/StringValue"
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("Meeting/StringValue/StringValue")) {
    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 id = result.id.Value;
    // TODO: Gör något med resultatet
}


$URL = "https://connect.maklare.vitec.net/Meeting/StringValue/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);

$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["id"];
// TODO: Gör något med resultatet

Testformulär Text input

Username

Password

customerId

Response Formats

application/json, text/json
application/xml, text/xml

{
  "id": "sample string 1",
  "contactId": "sample string 2",
  "contactName": "sample string 3",
  "address": {
    "streetAddress": "sample string 1",
    "zipCode": "sample string 2",
    "city": "sample string 3",
    "countryCode": "sample string 4"
  },
  "telePhone": "sample string 4",
  "cellPhone": "sample string 5",
  "meetingDate": "2024-05-02T19:35:52.1442549+02:00",
  "type": "Assignment",
  "brokerId": "sample string 7",
  "brokerName": "sample string 8",
  "bookedById": "sample string 9",
  "bookedByName": "sample string 10",
  "bookedDate": "2024-05-02T19:35:52.1442549+02:00",
  "signatureDate": "2024-05-02T19:35:52.1442549+02:00",
  "estateStatus": {
    "id": "sample string 1",
    "name": "sample string 2"
  },
  "commissionWithoutTaxes": 12.0,
  "commissionSource": "sample string 13",
  "assignmentSource": {
    "id": 1,
    "name": "sample string 2"
  },
  "cancelledBy": "sample string 14",
  "agreementDate": "2024-05-02T19:35:52.1442549+02:00",
  "commissionType": "Sale",
  "accessDate": "2024-05-02T19:35:52.1442549+02:00",
  "estateId": "sample string 15"
}

<Meeting xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Meeting">
  <AccessDate>2024-05-02T19:35:52.1442549+02:00</AccessDate>
  <Address xmlns:d2p1="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models">
    <d2p1:City>sample string 3</d2p1:City>
    <d2p1:CountryCode>sample string 4</d2p1:CountryCode>
    <d2p1:StreetAddress>sample string 1</d2p1:StreetAddress>
    <d2p1:ZipCode>sample string 2</d2p1:ZipCode>
  </Address>
  <AgreementDate>2024-05-02T19:35:52.1442549+02:00</AgreementDate>
  <AssignmentSource>
    <Id>1</Id>
    <Name>sample string 2</Name>
  </AssignmentSource>
  <BookedById>sample string 9</BookedById>
  <BookedByName>sample string 10</BookedByName>
  <BookedDate>2024-05-02T19:35:52.1442549+02:00</BookedDate>
  <BrokerId>sample string 7</BrokerId>
  <BrokerName>sample string 8</BrokerName>
  <CancelledBy>sample string 14</CancelledBy>
  <CellPhone>sample string 5</CellPhone>
  <CommissionSource>sample string 13</CommissionSource>
  <CommissionType>Sale</CommissionType>
  <CommissionWithoutTaxes>12</CommissionWithoutTaxes>
  <ContactId>sample string 2</ContactId>
  <ContactName>sample string 3</ContactName>
  <EstateId>sample string 15</EstateId>
  <EstateStatus xmlns:d2p1="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Estate.Common">
    <d2p1:Id>sample string 1</d2p1:Id>
    <d2p1:Name>sample string 2</d2p1:Name>
  </EstateStatus>
  <Id>sample string 1</Id>
  <MeetingDate>2024-05-02T19:35:52.1442549+02:00</MeetingDate>
  <SignatureDate>2024-05-02T19:35:52.1442549+02:00</SignatureDate>
  <TelePhone>sample string 4</TelePhone>
  <Type>Assignment</Type>
</Meeting>