ACCESSING THE CV VILLAS WHITE LABEL API

This section documents how partners may access the White Label API using the API Key provided by CV Villas.

Alle Partner können auf die White-Label-API mit dem von CV Villas bereitgestellten API-Schlüssel zugreifen. Es handelt sich um eine GET-Anforderung, die standardmäßig XML zurückgibt und auf die über den folgenden Endpunkt zugegriffen werden kann:

Endpunkt

https://www.cvvillas.com/umbraco/api/Travel/GetTravelItems/

Parameter

SchlüsselTypBeispielwertErfordernis
apiKeyGUID-Zeichenfolge97a30c39-4d62-4849-abef-d52d7b7044aeerforderlich
StartDatumString2020-09-20fakultativ
EnddatumString2020-09-30fakultativ

Endpunkt

https://www.cvvillas.com/umbraco/api/Travel/v2/GetGeography/

Parameter

SchlüsselTypBeispielwertErfordernis
apiKeyGUID-Zeichenfolge97a30c39-4d62-4849-abef-d52d7b7044aeerforderlich

Neu in Version 2

Um auf Version 2 der API zuzugreifen, müssen Sie der URL „/v2“ Segment hinzufügen. z.B. „/umbraco/api/Travel/v2/GetTravelItems/“

Änderungen:

https://www.cvvillas.com/umbraco/api/Travel/v2/GetTravelItems/

„Unterkunft“, „Einrichtungen“, „LocationFeatures“ und „ServiceAndStaffing“ Felder haben nun strukturiertere Daten, einschließlich Tooltip-Informationen, falls vorhanden.
Diese Listen geben nun das Feld „Item2“ mit „Text“ mit den zuvor zurückgegebenen Werten undTooltip“ mit Tooltip-Text zurück, falls vorhanden.

https://cvvillas.com/umbraco/api/travel/v2/GetAvailability/

Die Dauerliste gibt nun ein aktualisiertes Feld „DurationItemv2“ zurück, das sowohl die Felder Min und auch Max enthält.


Zugriff als JSON

Wenn Sie eine JSON-Antwort von der API anstelle einer XML-Antwort erhalten möchten, übergeben Sie den Accept-Header mit dem Wert application/json.

 

Anmerkungen: Zum Testen empfehlen wir dem Partner, ein Tool wie Postman zu verwenden und nicht zu versuchen, die API in seinem Browser zu laden, da es wahrscheinlich zum Absturz kommt, weil der Browser versucht, die große Menge an XML zu formatieren, obwohl er die API geladen hat.