Dokumentation för API-funktioner
POST Appointment/{customerId}/{id} Skapa kalenderhändelse Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kund-id string Krävs
id Id på användaren string Krävs
Body Parameters Kalenderhändelse Appointment
NamnBeskrivningTypInformation
Subject Ämne string

Location Plats string

StartsAt Startdatum och tid date

EndsAt Slutdatum och tid date

AllDayEvent Hela dagen boolean

Note Anteckning string

Recurrence Återkommande boolean

RecurrencePattern Återkommande per år/månad/vecka/dag RecurrencePattern

RecurrenceDayOfWeeks Dag/dagar i veckan (används får veckoliga möten) Collection of DayOfWeek

RecurrenceInterval Interval integer

RecurrenceMonth Månaden (används för månatliga möten) integer

RecurrenceDay Dag i månaden (använs för årliga och månatliga möten) integer

Request Formats

{
  "subject": "sample string 1",
  "location": "sample string 2",
  "startsAt": "2024-11-21T12:24:53.2003984+01:00",
  "endsAt": "2024-11-21T12:24:53.2003984+01:00",
  "allDayEvent": true,
  "note": "sample string 5",
  "recurrence": true,
  "recurrencePattern": "Daily",
  "recurrenceDayOfWeeks": [
    "Sunday",
    "Sunday"
  ],
  "recurrenceInterval": 6,
  "recurrenceMonth": 7,
  "recurrenceDay": 8
}
<Appointment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models.Appointment">
  <AllDayEvent>true</AllDayEvent>
  <EndsAt>2024-11-21T12:24:53.2003984+01:00</EndsAt>
  <Location>sample string 2</Location>
  <Note>sample string 5</Note>
  <Recurrence>true</Recurrence>
  <RecurrenceDay>8</RecurrenceDay>
  <RecurrenceDayOfWeeks>
    <DayOfWeek>Sunday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </RecurrenceDayOfWeeks>
  <RecurrenceInterval>6</RecurrenceInterval>
  <RecurrenceMonth>7</RecurrenceMonth>
  <RecurrencePattern>Daily</RecurrencePattern>
  <StartsAt>2024-11-21T12:24:53.2003984+01:00</StartsAt>
  <Subject>sample string 1</Subject>
</Appointment>
Response Information Resource Description Skapa kalenderhändelse string Kodexempel

curl "https://connect.maklare.vitec.net/Appointment/StringValue/StringValue" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"subject\":\"StringValue\",\"location\":\"StringValue\",\"startsAt\":\"2015-01-01T12:00:00\"}
            

$URL = "https://connect.maklare.vitec.net/Appointment/StringValue/StringValue"
$data = "{`"subject`":`"StringValue`",`"location`":`"StringValue`",`"startsAt`":`"2015-01-01T12:00:00`"}"
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 = "{\"subject\":\"StringValue\",\"location\":\"StringValue\",\"startsAt\":\"2015-01-01T12:00:00\"}";
using (var response = await HttpClientInstance.PostAsync("Appointment/StringValue/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);
    
    // TODO: Gör något med resultatet
}

$URL = "https://connect.maklare.vitec.net/Appointment/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);
$data = "{\"subject\":\"StringValue\",\"location\":\"StringValue\",\"startsAt\":\"2015-01-01T12:00:00\"}";
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
}

// TODO: Gör något med resultatet
Testformulär Text input
Response Formats
"sample string 1"
<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">sample string 1</string>