Was ist CarAPI?

API, "Application Programming Interface", ist eine definierte Schnittstelle für Softwareentwickler. Diese ermöglicht die Nutzung bestimmter Dienste eines API-Anbieters.

Mit unserem Webservice CarAPI können Sie Fahrzeuge von einem oder mehreren Autohäusern direkt aus der CarCopy-Datenbank abrufen. Dazu wird ein Request in XML erstellt, der mit der HTTP-POST Methode an die CarAPI geschickt wird. Die API sendet die angeforderten Daten in einem Result zurück.

Die Daten werden in XML angefordert und geliefert. Damit geniessen Sie die höchste Flexibilität bei der Weiterverarbeitung Ihrer Daten.

Technik

Der CarAPI-Webservice wird Ihnen über SOAP bereitgestellt. Das bedeutet, dass die Programmiersprache, in der Sie auf die API zugreifen wollen, SOAP und WSDL verstehen muss. Ein Großteil der heute aktuellen Programmiersprachen bringen eigene SOAP-Klienten mit. Als Beispiel wären hier PHP 5 oder C# zu nennen. Bei Sprachen, die keinen SOAP-Klienten mitbringen, haben sich meist Standardlösungen durchgesetzt. Zu erwähnen wären hier Axis für Java und C++ (aber auch für PHP erhältlich) und für PHP 4 z. B. NuSOAP.

Links:
NuSOAP – http://dietrich.ganx4.com/nusoap/
WSF/PHP – http://wso2.org/projects/wsf/php/
Apache Axis – http://ws.apache.org/axis/

Authentifizierung

Um den CarAPI-Webservice zu nutzen, müssen sie bei jedem Request den Ihnen nach der Registrierung zugesandten API-Key im SOAP-Header mitsenden. Der API Key muss den Namespace “http://www.carcopy.com/WS/WXApi/1.0/” haben, den Namen “apikey” tragen und als Wert Ihren API-Key enthalten. Ein fehlerhafter oder nicht vorhandener API-Key wird ihnen durch eine Exception mitgeteilt.
Die Erklärung der einzelnen Fehlercodes finden sie im Anhang B der Dokumentation.

Begrenzungen

maximal 50 KFZ gleichzeitig

Die Abfrage einer Ergebnisliste ist nur seitenweise möglich. Daher müssen Sie festlegen, wie viele Fahrzeuge Sie in einem Request abrufen wollen. Maximal 50 Fahrzeuge sind möglich. Diese Einschränkung ist aus Auslastungs- und Performancegründen nötig. Um weitere Fahrzeuge abzurufen, erstellen Sie einen neuen Request. Eine Sortierung der Objekte ist möglich.

Cachen von Abfragen

Wollen Sie Abfragen zwischenspeichern, dann denken Sie daran, dass ein Fahrzeug in der Zwischenzeit deaktiviert werden kann. Aktualisieren Sie deshalb ihre Daten regelmäßig!

10.000 Request pro 24 Stunden

Die CarAPI kann 24 Stunden am Tag und 7 Tage die Woche genutzt werden, es sei denn, dass innerhalb von 24 Stunden 10.000 Requests überschritten werden. Wenn der Nutzer auf der Basis der CarAPI eine Applikation erstellt, bezieht sich diese Begrenzung von 10.000 Requests innerhalb von 24 Stunden auf jede installierte Kopie dieser Applikation.

Angebotene Bildformate

Bilder werden bei CarCopy.com gehostet und per Link zur Verfügung gestellt.

Folgende Bildformate werden angeboten:

Full - Originalgröße (bis zu 2048 x 1536 Pixel)
Medium - 640 x 480 Pixel
Thumbnail - 72 x 54 Pixel

Filter


Diese Seite weiterempfehlen...

Schlagwörter: