Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- dokumentation_der_autofokus24_tree-soap-schnittstelle [2015-12-03 19:22]
Christian
+++ dokumentation_der_autofokus24_tree-soap-schnittstelle [2018-11-07 17:43] (aktuell)
admin Formatierung
@@ Zeile 1: / Zeile 1: @@
+====== Dokumentation der Autofokus24 Tree-Soap-Schnittstelle ======
 **Bitte beachten Sie, dass die SOAP-APIs nicht mehr aktiv weiterentwickelt werden. Neue Kunden sollten ausschließlich die RESTful API nutzen, bestehende Nutzer der SOAP-Schnittstellen sollten mittelfristig auf REST umstellen.**
+Eine allgemeine Beschreibung der SOAP-Schnittstelle finden Sie unter [[apis]].
-====== SOAP-Zugang ======
+===== SOAP-Zugang =====
-===== Zugangsdaten =====
+==== Zugangsdaten ====
-  *  Proxy/SOAP-Server: <code>https://www.autofokus24.de/autofokus24Tree.php</code>
-  *  WSDL-Datei:
-    *  <code>https://www.autofokus24.de/autofokus24Tree.php?wsdl</code>
-    *  <code>https://autofokus24.de/genwsdl.php?type=tree</code>
-    *  //Hinweis: <code>http://www.autofokus24.de/autofokus24Tree.wsdl</code> wird nicht mehr unterstützt!//
-  *  Encoding: <code>UTF-8</code>
-  *  Namespace/URN: <code>autofokus24</code>
+  * Proxy/SOAP-Server: ''https://autofokus24.de/autofokus24Tree.php''
+  * WSDL-Datei:
+    * ''https://autofokus24.de/autofokus24Tree.php?wsdl''
+    * ''https://autofokus24.de/genwsdl.php?type=tree''
+    * //Hinweis: ''http://www.autofokus24.de/autofokus24Tree.wsdl'' wird nicht mehr unterstützt!//
+  * Encoding: ''UTF-8''
+  * Namespace/URN: ''autofokus24''
-====== Funktionen ======
+===== Funktionen =====
-===== login =====
+==== login ====
 Syntax: <code>bool login ( string username, string password [ ,bool useSoapFaults = false] )</code>
 Mit dieser Funktion loggen Sie sich mit Ihrem Nutzernamen/Passwort im System ein. Der Login wird serverseitig in einer Session gehalten, dafür ist es aber notwendig, dass Sie clientseitig das Setzen von Cookies ermöglichen. Sollte dies nicht möglich sein, kann bei jedem anderen Funktionsaufruf der Nutzername und das Passwort als letzter optionaler Parameter übergeben werden.
-  *  Parameter
+  * Parameter
- username: Ihr Nutzername
+    * username: Ihr Nutzername
- password: Ihr Passwort
+    * password: Ihr Passwort
-  *  Rückgabewert
+  * Rückgabewert
- Liefert true im erfolgsfall zurück. Liefert false im Fehlerfall zurück. Sollte die Ausnahmebehandlung aktiviert sein (useSoapFaults=true) wird ein Fehler (Exception) geworfen.
+    * Liefert true im Erfolgsfall zurück. Liefert false im Fehlerfall zurück. Sollte die Ausnahmebehandlung aktiviert sein (useSoapFaults=true) wird ein Fehler (Exception) geworfen.
-===== getMakes =====
+==== getMakes ====
 Syntax: <code>array getMakes([string username = "" [, string password = "" ]]) </code>
@@ Zeile 38: / Zeile 42: @@
 Diese Funktion liefer ein Array der möglichen Marken/Hersteller (Audi, Opel, VW etc.). Es werden die Bezeichnungen (Name) der Hersteller sowie die Autofokus24-interne Id dieser Hersteller zurückgegeben. Diese Id ist für die nächsten Funktionsaufrufe erforderlich.
-  *  Parameter
+  * Parameter
- username (optional): Ihr Nutzername, falls das Sessionhandling durch die Funktion login(...) nicht funktioniert.
+    * username (optional): Ihr Nutzername, falls das Sessionhandling durch die Funktion login(...) nicht funktioniert.
- password (optional): Ihr Passwort, falls das Sessionhandling durch die Funktion login(...) nicht funktioniert.
+    * password (optional): Ihr Passwort, falls das Sessionhandling durch die Funktion login(...) nicht funktioniert.
+  * Rückgabewert
+    * Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Make" der Hersteller/Marken zurück. "Id" ist dabei die Autofokus24-interne Id des Herstellers/Marke und "Make" ist der Name der angezeigt werden kann (analog autofokus24.de).
-  *  Rückgabewert
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Make" der Hersteller/Marken zurück. "Id" ist dabei die Autofokus24-interne Id des Herstellers/Marke und "Make" ist der Name der angezeigt werden kann (analog autofokus24.de).
+==== getModels ====
-===== getModels =====
 Syntax: <code>array getModels (int year, int month, int makeId) </code>
@@ Zeile 52: / Zeile 55: @@
 Diese Funktion liefert die möglichen Modelle abhängig von der übergebenen Marke (anhand der makeId sowie Jahr und Monat der Erstzulassung). In diesem Schritt erfolgt bereits die erste Optimierung der möglichen Eingabewerte: (Beispiel: Wir wissen, dass es sich um einen Opel aus dem Jahr 01/2002 handelt. Aus diesen Informationen schließen wir, dass es sich nur um bestimmte Modelle handeln kann und nicht wie etwa einen Opel Kadett oder Opel Senator. Zur Veranschaulichung hilft es, sich die Modellstruktur der Autofoks24-Seite zu betrachten.
-  *  Parameter
+  * Parameter
- year: Jahr der Erstzulassung.
+    * year: Jahr der Erstzulassung.
- month: Monat der Erstzulassung.
+    * month: Monat der Erstzulassung.
- makeId: Id der Marke, dessen Modelle ausgegeben werden sollen.
+    * makeId: Id der Marke, dessen Modelle ausgegeben werden sollen.
+  * Rückgabewert
+    * Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Model" der Modelle zurück. "Id" ist dabei die autofokus24-interne Id des Modells und "Model" ist der Name der angezeigt werden kann (analog autofokus24.de).
-  *  Rückgabewert
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Model" der Modelle zurück. "Id" ist dabei die autofokus24-interne Id des Modells und "Model" ist der Name der angezeigt werden kann (analog autofokus24.de).
+==== getSubmodels ====
-===== getSubmodels =====
 Syntax: <code>array getSubmodels (int year, int month, int modelId) </code>
 Diese Funktion liefert die möglichen Submodelle (Untermodelle, zum Beispiel "Golf 3" oder "Polo 6N1") abhängig vom übergebenen Modell (anhand der modelId sowie Jahr und Monat der Erstzulassung).
-  *  Parameter
+  * Parameter
- year: Jahr der Erstzulassung.
+    * year: Jahr der Erstzulassung.
- month: Monat der Erstzulassung.
+    * month: Monat der Erstzulassung.
- modelId: Id des Models, dessen Submodelle (Untermodelle) ausgegeben werden sollen.
+    * modelId: Id des Models, dessen Submodelle (Untermodelle) ausgegeben werden sollen.
+  * Rückgabewert
+    * Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Model" der Submodelle/Untermodelle zurück. "Id" ist dabei die Autofokus24-interne Id des Submodells/Untermodell und "Model" ist der Name der angezeigt werden kann (analog autofokus24.de).
-  *  Rückgabewert
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id" und "Model" der Submodelle/Untermodelle
-zurück. "Id" ist dabei die Autofokus24-interne Id des Submodells/Untermodell und "Model"
-ist der Name der angezeigt werden kann (analog autofokus24.de).
+==== getBuildtypes ====
-===== getBuildtypes =====
 Syntax: <code>array getBuildtypes (int year, int month, int submodelId) </code>
 Diese Funktion liefert die möglichen Aufbauvarianten (zum Beispiel "Limousine" oder "Kombi") sowie die Anzahl der Türen abhängig vom übergebenen Submodell (anhand der SubmodelId sowie Jahr und Monat der Erstzulassung).
-  *  Parameter
- year: Jahr der Erstzulassung.
- month: Monat der Erstzulassung.
- submodelId: Id des Submodells, deren Aufbauvarianten ausgegeben werden sollen.
-  *  Rückgabewert
+  * Parameter
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "Buildtype" und "Doors" der möglichen Aufbauvarianten. "Id" ist dabei die Autofokus24-interne Id der Aufbauvariante, Buildtype ist ist der Name der angezeigt werden kann (analog autofokus24.de), Doors ist die Anzahl der Türen.
+    * year: Jahr der Erstzulassung.
+    * month: Monat der Erstzulassung.
+    * submodelId: Id des Submodells, deren Aufbauvarianten ausgegeben werden sollen.
+  * Rückgabewert
+    * Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "Buildtype" und "Doors" der möglichen Aufbauvarianten. "Id" ist dabei die Autofokus24-interne Id der Aufbauvariante, Buildtype ist ist der Name der angezeigt werden kann (analog autofokus24.de), Doors ist die Anzahl der Türen.
-===== getMotors =====
+==== getMotors ====
 Syntax: <code>array getMotors (int year, int month, int submodelId, int buildtypeId) </code>
 Diese Funktion liefert die möglichen Motorisierungen (Leistung, Kraftstoffart, Anzahl Zylinder sowie Hubraum) abhängig vom übergebenen Submodell und der Aufbauvariante (anhand der SubmodelId, BuildtypeId sowie Jahr und Monat der Erstzulassung).
-  *  Parameter
+  * Parameter
- year: Jahr der Erstzulassung.
+     * year: Jahr der Erstzulassung.
- month: Monat der Erstzulassung.
+     * month: Monat der Erstzulassung.
- submodelId: Id des Submodells, dessen Motorisierungen ausgegeben werden sollen.
+     * submodelId: Id des Submodells, dessen Motorisierungen ausgegeben werden sollen.
- buildtypeId: Id der Aufbauvariante, deren Motorisierungen ausgegeben werden sollen.
+     * buildtypeId: Id der Aufbauvariante, deren Motorisierungen ausgegeben werden sollen.
+  * Rückgabewert
+     * Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "kW", "PS", "Fuel", "Cylinder" Motorisierungen. "Id" ist dabei die Autofokus24-interne Id der Motorisierung, "kW" Motorleistung in Kilowatt, "PS" Motorleistung in PS, "Fuel" Kraftstoffart, "Cylinder" Anzahl der Zylinder, "Cubic" Hubraum in Litern.
-  *  Rückgabewert
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "kW", "PS", "Fuel", "Cylinder" Motorisierungen. "Id" ist dabei die Autofokus24-interne Id der Motorisierung, "kW" Motorleistung in Kilowatt, "PS" Motorleistung in PS, "Fuel" Kraftstoffart, "Cylinder" Anzahl der Zylinder, "Cubic" Hubraum in Litern.
+==== getFokuscodes ====
-===== getFokuscodes =====
 Syntax: <code>array getFokuscodes (int year, int month, int submodelId, int buildtypeId, int motorId) </code>
 Diese Funktion liefert die sogenannten "Fokuscodes", welche die Sondermodelle repräsentieren. Die Menge der Fokuscodes ist die letzte Ebene innerhalb der Modellstruktur von Autofokus24. An den Fokuscodes werden die KBA-Daten (HSN/TSN) referenziert. Mit diesen KBA-Daten kann dann weiter verfahren werden (zum Beispiel die Durchführung einer Fahrzeugbewertung).
-  *  Parameter
+  * Parameter
- year: Jahr der Erstzulassung.
+     * year: Jahr der Erstzulassung.
- month: Monat der Erstzulassung.
+     * month: Monat der Erstzulassung.
- submodelId: Id des Submodells, dessen Fokuscodes ausgegeben werden sollen.
+     * submodelId: Id des Submodells, dessen Fokuscodes ausgegeben werden sollen.
- buildtypeId: Id der Aufbauvariante, deren Fokuscodes ausgegeben werden sollen.
+     * buildtypeId: Id der Aufbauvariante, deren Fokuscodes ausgegeben werden sollen.
+  * Rückgabewert
+     * Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "Name", "HSN", "TSN", "AlternateTSNs". "AlternateTSNs" ist dabei eine komma-separierte Liste, mit alternativen Typschlüsselnummern
-  *  Rückgabewert
- Liefert ein Array mit Attribut-Wert-Paaren aus "Id", "Name", "HSN", "TSN", "AlternateTSNs". "AlternateTSNs" ist dabei eine komma-separierte Liste, mit alternativen Typschlüsselnummern
+===== Tutorials =====
-====== Tutorials ======
+Im folgenden Abschnitt werden einige einfache Beispiele zur Verwendung der Autofokus24Tree-SOAP-Schnittstelle von Autofokus24.de dargestellt.
-Im folgenden Abschnitt werden einige einfache Beispiele zur Verwendung der Autofokus24Tree-SOAP-Schnittstelle von Autofokus24.de dargestellt.
+==== PHP-Tutorial ====
-===== PHP-Tutorial =====
 Für die Verwendung in PHP benötigen Sie die [[http://www.php.net/manual/de/class.soapclient.php|PHP-SoapClient-Klasse]].
-==== Initialisierung, Login und alle Marken holen ====
+=== Initialisierung, Login und alle Marken holen ===
 Code:
 <code>
   <?php
    try {
    /* Initialisierung: WSDL-Datei angeben, Caching deaktivieren, Encoding festlegen*/
    $client = new SOAPClient('http://www.autofokus24.de/autofokus24Tree?wsdl',
@@ Zeile 146: / Zeile 142: @@
                                    'encoding'=>'ISO-8859-1')
                             );
    /* Login: Mit eMail, Passwort. SoapFaults auf 1 setzen*/
    $client->login("mymail@myhost.de","meinpasswort",1);
    /* Fahrzeug ermitteln, Preis berechnen und Ergebnis formatiert ausgeben...*/
    print_r($client->getMakes());
    }catch (SOAPFault $f)
    {
      print $f->faultstring;
@@ Zeile 178: / Zeile 174: @@
-==== Modelle von VW aus 01/1996 holen ====
+=== Modelle von VW aus 01/1996 holen ===
 Code:
 <code>
   <?php
    try {
    print_r($client->getModels(1996,1,37));
    }catch (SOAPFault $f)
    {
      print $f->faultstring;
@@ Zeile 246: / Zeile 242: @@
-==== Untermodelle von VW Polo aus 01/1996 holen ====
+=== Untermodelle von VW Polo aus 01/1996 holen ===
 Code:
 <code>
   <?php
    try {
    print_r($client->getSubmodels(1996,1,866));
    }catch (SOAPFault $f)
    {
      print $f->faultstring;
@@ Zeile 274: / Zeile 270: @@
-==== Aufbauarten von VW Polo 3 aus 01/1996 holen ====
+=== Aufbauarten von VW Polo 3 aus 01/1996 holen ===
 Code:
 <code>
   <?php
    try {
    print_r($client->getBuildtypes(1996,1,1216));
    }catch (SOAPFault $f)
    {
      print $f->faultstring;
@@ Zeile 303: / Zeile 299: @@
 </code>
-==== Motorisierungen von VW Polo 3 01/1996, Limousine (3-Türig) holen ====
+=== Motorisierungen von VW Polo 3 01/1996, Limousine (3-Türig) holen ===
 Code:
 <code>
   <?php
    try {
    print_r($client->getMotors(1996,1,1216,44));
    }catch (SOAPFault $f)
    {
      print $f->faultstring;
@@ Zeile 366: / Zeile 362: @@
-==== Fokuscodes von VW Polo 3 01/1996, Limousine (3-Türig), Benziner, 1.4 Liter holen ====
+=== Fokuscodes von VW Polo 3 01/1996, Limousine (3-Türig), Benziner, 1.4 Liter holen ===
 Code:
 <code>
   <?php
    try {
    print_r($client->getFokuscodes(1996,1,1216,44,798));
    }catch (SOAPFault $f)
    {
      print $f->faultstring;

Autofokus24 Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge