Dokumentation för API-funktioner
GET Advertising/Office/{customerId}/{officeId}

Hämta kontor för hemsida.

Request Information URI Parameters
NamnBeskrivningTypInformation
customerId Kund-id string Krävs
officeId Kontorsid string Krävs
Response Information Resource Description

Hämta kontor för hemsida.

AdvertisingOffice
NamnBeskrivningTypInformation
Id Id string

CustomerId Kund-id string

ChangedAt Ändringsdatum date

BrandId Varumärkes-id string

Name Namn på kontoret string

StreetAddress Gatuadress/Besöksadress string

ZipCode Postnr AdvertisingZipCode

PostalTown Ort string

Telephone Telefonnummer AdvertisingOfficeTelephoneNumbers

EmailAddress E-postadress string

Seat Säte string

Description Beskrivning string

Coordinate Koordinater Wgs84Coordinate

Kodexempel

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

$URL = "https://connect.maklare.vitec.net/Advertising/Office/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("Advertising/Office/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/Advertising/Office/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
Response Formats
{
  "id": "sample string 1",
  "customerId": "sample string 2",
  "changedAt": "2025-04-04T14:26:39.6953705+02:00",
  "brandId": "sample string 3",
  "name": "sample string 4",
  "streetAddress": "sample string 5",
  "zipCode": {
    "numerical": 1,
    "value": "sample string 1"
  },
  "postalTown": "sample string 6",
  "telephone": {
    "switch": {
      "msisdn": "sample string 1",
      "display": "sample string 2"
    }
  },
  "emailAddress": "sample string 7",
  "seat": "sample string 8",
  "description": "sample string 9",
  "coordinate": {
    "longitude": 1.1,
    "latitude": 2.1
  }
}
<AdvertisingOffice xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Services.Advertising">
  <BrandId>sample string 3</BrandId>
  <ChangedAt>2025-04-04T14:26:39.6953705+02:00</ChangedAt>
  <Coordinate xmlns:d2p1="http://schemas.datacontract.org/2004/07/Vitec.Housing.Connect.Api.Models">
    <d2p1:Latitude>2.1</d2p1:Latitude>
    <d2p1:Longitude>1.1</d2p1:Longitude>
  </Coordinate>
  <CustomerId>sample string 2</CustomerId>
  <Description>sample string 9</Description>
  <EmailAddress>sample string 7</EmailAddress>
  <Id>sample string 1</Id>
  <Name>sample string 4</Name>
  <PostalTown>sample string 6</PostalTown>
  <Seat>sample string 8</Seat>
  <StreetAddress>sample string 5</StreetAddress>
  <Telephone>
    <Switch xmlns:d3p1="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Models">
      <d3p1:Display>sample string 2</d3p1:Display>
      <d3p1:Msisdn>sample string 1</d3p1:Msisdn>
    </Switch>
  </Telephone>
  <ZipCode>
    <Numerical>1</Numerical>
    <Value>sample string 1</Value>
  </ZipCode>
</AdvertisingOffice>