{ "firstName": "sample string 1", "lastName": "sample string 2", "email": "sample string 3", "cellPhone": "sample string 4", "address": { "streetAddress": "sample string 1", "zipCode": "sample string 2", "city": "sample string 3" }, "gdpr": { "hasApproved": true }, "lead": { "assignmentSourceId": "sample string 1", "leadSourceId": "sample string 2", "message": "sample string 3" }, "marketing": { "referrer": "sample string 1", "utmTags": [ { "name": "sample string 1", "value": "sample string 2" }, { "name": "sample string 1", "value": "sample string 2" } ] }, "receiver": { "userId": "sample string 1" } }
Dokumentation för API-funktioner
POST v2/Advertising/Form/{customerId}/Valuation
Värderingsförfrågan
Request Information
URI Parameters
Body Parameters
Anmälningsuppgifter ValuationApplication
Response Information
Resource Description
Värderingsförfrågan
ValuationResult
Kodexempel
Testformulär
Text input
Response Formats
Namn | Beskrivning | Typ | Information |
customerId | Kund-id | string |
Krävs |
Namn | Beskrivning | Typ | Information |
FirstName | Förnamn | string | |
LastName | Efternamn | string | |
Epostadress | string | ||
CellPhone | Mobiltelefonnummer | string | |
Address | Adressuppgifter, valfritt | FormAddress | |
Gdpr | GDPR uppgifter | FormApplicationGdpr | |
Lead | Lead uppgifter | FormValuationApplicationLead | |
Marketing | Marknadsföringsuppgifter som t ex UTM taggar | FormMarketing | |
Receiver | Mottagare av värderingsförfrågan | ApplicationReceiver |
Request Formats
<ValuationApplication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Services.Advertising"> <Address> <City>sample string 3</City> <StreetAddress>sample string 1</StreetAddress> <ZipCode>sample string 2</ZipCode> </Address> <CellPhone>sample string 4</CellPhone> <Email>sample string 3</Email> <FirstName>sample string 1</FirstName> <Gdpr> <HasApproved>true</HasApproved> </Gdpr> <LastName>sample string 2</LastName> <Lead> <LeadSourceId>sample string 2</LeadSourceId> <Message>sample string 3</Message> <AssignmentSourceId>sample string 1</AssignmentSourceId> </Lead> <Marketing> <Referrer>sample string 1</Referrer> <UtmTags> <FormMarketingUtmTags> <Name>sample string 1</Name> <Value>sample string 2</Value> </FormMarketingUtmTags> <FormMarketingUtmTags> <Name>sample string 1</Name> <Value>sample string 2</Value> </FormMarketingUtmTags> </UtmTags> </Marketing> <Receiver> <UserId>sample string 1</UserId> </Receiver> </ValuationApplication>
Namn | Beskrivning | Typ | Information |
ContactId | string |
curl "https://connect.maklare.vitec.net/v2/Advertising/Form/StringValue/Valuation" -X POST -H "Content-Type: application/json" -H "Authorization: basic {Base64 kodad användarnamn och lösenord}" -d {\"firstName\":\"StringValue\",\"lastName\":\"StringValue\",\"email\":\"StringValue\"}
$URL = "https://connect.maklare.vitec.net/v2/Advertising/Form/StringValue/Valuation"
$data = "{`"firstName`":`"StringValue`",`"lastName`":`"StringValue`",`"email`":`"StringValue`"}"
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 = "{\"firstName\":\"StringValue\",\"lastName\":\"StringValue\",\"email\":\"StringValue\"}";
using (var response = await HttpClientInstance.PostAsync("v2/Advertising/Form/StringValue/Valuation", 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);
var contactId = result.contactId.Value ;
// TODO: Gör något med resultatet
}
$URL = "https://connect.maklare.vitec.net/v2/Advertising/Form/StringValue/Valuation";
$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 = "{\"firstName\":\"StringValue\",\"lastName\":\"StringValue\",\"email\":\"StringValue\"}";
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
}
$field_on_result = $result["contactId"];
// TODO: Gör något med resultatet
Resultat av begäran
{ "contactId": "sample string 1" }
<ValuationResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Connect.Api.Services.Advertising"> <ContactId>sample string 1</ContactId> </ValuationResult>