Webservice API: Unterschied zwischen den Versionen

Aus TopData WIKI
Wechseln zu: Navigation, Suche
 
(27 dazwischenliegende Versionen des gleichen Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
−
<h2> Webservice Api Basics</h2>
+
<languages />
−
<h3> Use</h3>
+
<br />
−
<p> By accessing our web service, you automatically declare that you understand and accept our  [[web service use conditions]].<br><br>
+
<translate>
−
Access is logged and evaluated. To save access/bandwidth and
+
<!--T:1-->
−
server capacity, we recommend minimising queries to the web service via data caching
+
<h2>Webservice API Grundlagen</h2>
−
(if possible). We reserve the right to limit access or even to block it if access to the web service
+
<h3>Nutzung</h3>
−
exceeds a plausible level.<br/>
+
<p>Mit dem Zugang zum Webservice haben Sie automatisch unsere [[Webservice Nutzungsbedingungen]] verstanden und akzeptiert.<br><br>
−
Access data may not be provided to third parties or displayed publicly. Certain previously
+
Zugriffe werden geloggt und ausgewertet. Um Zugriffe/Bandbreite sowie Serverkapazitäten zu sparen, wird empfohlen, die Anfragen an den Webservice (soweit es geht), durch Datencaching zu minimieren. Wir behalten uns das Recht vor, Zugänge einzuschränken oder gegebenenfalls auch zu sperren, sollte der Zugriff zum Webservice über ein plausibles Mass hinausgehen.<br>
−
agreed data is approved for use as your access details.</p>
+
Zugangsdaten dürfen nicht an Dritte weitergegeben oder öffentlich dargestellt werden.<br>
−
<h3> Data format: </h3>
+
Für Ihre Zugangsdaten sind bestimmte, vorher vereinbarte, Daten freigegeben.
 +
</p>
 +
<h3>Datenformat</h3>
 
<p>
 
<p>
−
The web service is returned in the JSON format. We have decided against XML because JSON is currently equally as popular and reduces overhead compared with XML.
+
Die Rückgabe des Webservices erfolgt im [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] Format.
−
[http://de.wikipedia.org/wiki/JavaScript_Object_Notation#Unterschied_zu_XML More Information]
+
Wir haben uns gegen XML entschieden, da JSON inzwischen genauso weit verbreitet ist und gegenüber XML den Overhead reduziert. [http://de.wikipedia.org/wiki/JavaScript_Object_Notation#Unterschied_zu_XML Mehr Informationen]
 
</p>
 
</p>
−
<h3> Character encoding </h3>
+
<h3>Zeichencodierung</h3>
 
<p>
 
<p>
−
data from the web services is released [http://de.wikipedia.org/wiki/UTF-8 UFT8]
+
Die Ausgabe der Daten des Webservices erfolgt in [http://de.wikipedia.org/wiki/UTF-8 UFT8]
 
</p>
 
</p>
−
<h3>Access</h3>
+
<h3>Zugang</h3>
 
<p>
 
<p>
−
The web service data is accessed via a fixed HTTP URL </p>
+
Der Abruf der Webservice-Daten erfolgt über eine feste HTTP URL.
−
<source lang="text">http://ws.cloud.topdata.de</source>
+
</p>
−
<p> Access data is required to access the web service, which is comprised as follows:
+
</translate>
 +
<source lang="text">https://ws.topdata.de</source>
 +
<translate>
 +
<!--T:2-->
 +
<p>Für den Zugang zum Webservice werden Zugangsdaten benötigt, die sich wie folgt zusammensetzen:
 
* User ID (''%uid%'')
 
* User ID (''%uid%'')
 
* Passwort (''%password%'')
 
* Passwort (''%password%'')
 
* Sicherheitscode (''%security_key%'')
 
* Sicherheitscode (''%security_key%'')
−
The access data must be transferred as an HTTP request each time the web service is accessed.  
+
Die Zugangsdaten müssen bei jedem Aufruf des Webservices als HTTP Request mit übergeben werden.
 
</p>
 
</p>
 +
</translate>
 
<source lang="text">?uid=%uid%&security_key=%security_key%&password=%password%</source>
 
<source lang="text">?uid=%uid%&security_key=%security_key%&password=%password%</source>
−
<p> The following HTTP request variables are required to receive a response from the web service.
+
<translate>
 +
<!--T:3-->
 +
<p>Weiter sind folgende HTTP Request Variablen Pflicht, um eine Antwort vom Webservice zu erhalten
 
* [[Webservice_API#API-Version|API-Version]] (''%version%'')
 
* [[Webservice_API#API-Version|API-Version]] (''%version%'')
 
* [[Webservice_API#Sprache|Sprache]] (''%language%'')
 
* [[Webservice_API#Sprache|Sprache]] (''%language%'')
 
</p>
 
</p>
 +
</translate>
 
<source lang="text">?uid=%uid%&security_key=%security_key%&password=%password%&version=%version%&language=%language%</source>
 
<source lang="text">?uid=%uid%&security_key=%security_key%&password=%password%&version=%version%&language=%language%</source>
 +
<translate>
 +
<!--T:4-->
 
<h3>API-Version</h3>
 
<h3>API-Version</h3>
−
If the web service is changed, then a new API version will be provided so that your own application does not always also need to be updated. ATTENTION: We can only provide support for the latest API version.
+
Sollten Änderungen am Webservice stattfinden, wird eine neue API-Version vergeben, damit Ihre eigene Applikation nicht immer mit geupdatet werden muss. ACHTUNG, Support unsererseits kann nur für die jeweils aktuelle API-Version geleistet werden.
−
* actual APIVersion: '''100'''
+
* Aktuelle APIVersion: '''110'''
−
<source lang="text">?version=100</source>
+
</translate>
−
<h3>Language</h3>
+
<source lang="text">?version=110</source>
−
The language must be provided as per [http://de.wikipedia.org/wiki/ISO_639#ISO_639-1 ISO 639-1]  
+
<translate>
 +
<!--T:5-->
 +
<h3>Sprache</h3>
 +
Die Sprache muss nach [http://de.wikipedia.org/wiki/ISO_639#ISO_639-1 ISO 639-1] übergeben werden.
 +
</translate>
 
<source lang="text">?language=en</source>
 
<source lang="text">?language=en</source>
 +
<translate>
 +
<!--T:6-->
 
<h3>Error Codes</h3>
 
<h3>Error Codes</h3>
−
Overview of all errors:
+
Alle Fehler im Überblick
 
{| class="wikitable"
 
{| class="wikitable"
−
!Error Code!!Description
+
!Fehler Code!!Fehler Beschreibung
 
|-
 
|-
−
|''100''||unknown error
+
|''100''||Unbekannter Fehler
 
|-
 
|-
−
|''101''||404 – page not found
+
|''101''||404 - Seite nicht gefunden
 
|-
 
|-
−
|''102''||User ID not available or not valid
+
|''102''||User ID nicht vorhanden oder nicht valide
 
|-
 
|-
−
|''103''||safety code not available or not valid
+
|''103''||Sicherheitscode nicht vorhanden oder nicht valide
 
|-
 
|-
−
|''104''||password not available or not valid
+
|''104''||Passwort nicht vorhanden oder nicht valide
 
|-
 
|-
−
|''105''||API-Version not available or not valid
+
|''105''||API-Version nicht vorhanden oder nicht valide
 
|-
 
|-
−
|''106''||authentication failed
+
|''106''||Authentifizierung fehlgeschlagen
 
|-
 
|-
−
|''107''||language not available or not valid
+
|''107''||Sprache nicht vorhanden oder nicht valide
 
|-
 
|-
−
|''108''||template not found (please inform service)
+
|''108''||Template nicht gefunden (Bitte Service informieren)
 
|-
 
|-
−
|''109''||template error (please inform service)
+
|''109''||Template Fehler (Bitte Service informieren)
 
|-
 
|-
−
|''200''||product not found
+
|''110''||Filter nicht vorhanden oder nicht valide
 +
|-
 +
|''200''||Produkt nicht gefunden
 
|}
 
|}
−
<h2>Webservice API functions</h2>
+
 
−
<h3>My products</h3>
+
<!--T:7-->
−
<p>Sie You will receive all products activated for your access details in the form of a product list.</p>
+
<h2>Webservice API Funktionen</h2>
−
<source lang="text">http://ws.cloud.topdata.de/my_products</source>
+
<h3>Meine Produkte</h3>
−
<p>'''Example'''</p>
+
<p>Sie erhalten alle für Ihren Zugang aktivierten Produkte als [[Webservice_API#Produktliste|Produktliste]].</p>
−
By accessing:
+
</translate>
−
<source lang="text">http://ws.cloud.topdata.de/my_products?
+
<source lang="text">https://ws.topdata.de/my_products</source>
 +
<translate>
 +
<!--T:8-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/my_products?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 79: Zeile 106:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
−
<h3> Product groups </h3>
+
<!--T:9-->
−
<p> Accesses the complete product groups as a list::</p>
+
erhalten Sie die Produktliste als Rückgabe.
−
<source lang="text">http://ws.cloud.topdata.de/waregroups</source>
+
</translate>
−
<p>''' Example: '''</p>
+
<translate>
−
When accessing
+
<!--T:52-->
−
<source lang="text">http://ws.cloud.topdata.de/waregroups?
+
<h4>Meine Produkte nur mit Artikel-Nr.</h4>
 +
<p>Sie erhalten alle für Ihren Zugang aktivierten Produkte als [[Webservice_API#Produktliste|Produktliste]] wo eine Artikel-Nr. eines zugelassenen Anbieters hinterlegt ist.</p>
 +
<source lang="text">https://ws.topdata.de/distributor_products</source>
 +
<h3>Warengruppen</h3>
 +
<p>ruft die kompletten Warengruppen als Liste auf:</p>
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/waregroups</source>
 +
<translate>
 +
<!--T:10-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/waregroups?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 91: Zeile 131:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
you receive the following JSON output:
+
<translate>
 +
<!--T:11-->
 +
erhalten Sie folgende JSON Ausgabe:
 +
</translate>
 
<source lang="javascript">
 
<source lang="javascript">
 
{
 
{
Zeile 109: Zeile 152:
 
}
 
}
 
</source>
 
</source>
−
<h4>Products</h4>
+
<translate>
−
<p> Accesses all products contained in a specific product group. These are output as a [[Webservice_API#Produktliste|Productlist]].
+
<!--T:12-->
−
The product groups ID is required for this. This is can be obtained for example, by accessing the [[Webservice_API#Warengruppen|produktgroups]] or it is stored with one of the products </p>
+
<h4>Produkte</h4>
 +
<p>Ruft alle enthalten Produkte zu einer bestimmten Warengruppe ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Warengruppen ID notwendig. Diese erhalten Sie z.B. aus dem Aufruf der [[Webservice_API#Warengruppen|Warengruppen]] oder sie ist bei einem der Produkte hinterlegt</p>
 
* Warengruppen ID (%waregroup_id%)
 
* Warengruppen ID (%waregroup_id%)
−
<source lang="text">http://ws.cloud.topdata.de/waregroup/%warengroup_id%</source>
+
</translate>
−
<p>'''Example''</p>
+
<source lang="text">https://ws.topdata.de/waregroup/%warengroup_id%</source>
−
When accessing
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/waregroup/%warengroup_id%?
+
<!--T:13-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/waregroup/%warengroup_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 122: Zeile 172:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned
+
<translate>
−
<h3>Productlist</h3>
+
<!--T:14-->
−
<p>Die The product list includes all information about the products and is returned when certain web services are accessed.</p>
+
erhalten Sie die Produktliste als Rückgabe
−
* [[Webservice_API#Warengruppen|waregroup_products]]
+
 
 +
<!--T:15-->
 +
<h3>Produktliste</h3>
 +
<p>Die Produktliste enthält alle vom Filter zugelassenen Informationen zu den Produkten und wird bei bestimmten Webservice-Aufrufen zurückgegeben. Es gelten die selben [[Webservice_API#Filter|Filterangaben wie beim Produkt]]</p>
 +
* [[Webservice_API#Warengruppen|Warengruppen Produkte]]
 
* [[Webservice_API#bundle_content|''bundle_content'']]  
 
* [[Webservice_API#bundle_content|''bundle_content'']]  
 
* [[Webservice_API#product_alternates|''product_alternates'']]  
 
* [[Webservice_API#product_alternates|''product_alternates'']]  
 
* [[Webservice_API#product_is_alternate_of|''product_is_alternate_of'']]  
 
* [[Webservice_API#product_is_alternate_of|''product_is_alternate_of'']]  
 +
* [[Webservice_API#product_variants|''product_variants'']]
 
* [[Webservice_API#product_accessories|''product_accessories'']]  
 
* [[Webservice_API#product_accessories|''product_accessories'']]  
 
* [[Webservice_API#product_application_in|''product_application_in'']]
 
* [[Webservice_API#product_application_in|''product_application_in'']]
−
* [[Webservice_API#Anbieter Produkte|provider_products]]
+
* [[Webservice_API#Anbieter Produkte|Anbieter Produkte]]
−
<p>'''Example'''</p>
+
<p>'''Beispiel'''</p>
 +
</translate>
 
<source lang="javascript">
 
<source lang="javascript">
 
{
 
{
Zeile 147: Zeile 203:
 
}
 
}
 
</source>
 
</source>
−
<p> In order to keep traffic and loading times low, the product list is always divided into multiple pages. The individual pages may be accessed via an additional HTTP request variable:</p>
+
<translate>
 +
<!--T:16-->
 +
<p>Um den Traffic und die Ladezeit gering zu halten, wird die Produktliste immer in mehrere Seiten unterteilt. Die einzelnen Seiten können über eine weitere HTTP Request Variable angesteuert werden:</p>
 
<source lang="text">?page=3</source>
 
<source lang="text">?page=3</source>
−
<p> The product list includes information about the number of pages, the number of products, the number of products per page, and the currently selected sub-page.
+
<p>Die Produktliste beinhaltet Informationen über die Anzahl der Seiten, die Anzahl der Produkte, die Anzahl der Produkte pro Seite sowie die aktuell ausgewählte Unterseite.<br>
−
The products in the product list are displayed analogously to how individual products are accessed.
+
Die Produkte in der Produktliste werden analog zum Aufruf eines einzelnen Produktes dargestellt.
 
</p>
 
</p>
−
<h3>Product</h3>
+
<p>'''mehrere Produkte auf einmal abrufen (ab Version 103)'''</p>
−
<p> Accesses an individual product from the web service. The product ID is required for this.</p>
+
<p>Sie können auch einer Webservice Abfrage mehrere Produkt-IDs übergeben um dazu die Produktliste zu erhalten.
 +
Diese werden per Komma getrennten String übergeben. ACHTUNG es sind maxmimal 50 Produkt-IDs zugelassen (mehr werden ignoriert).
 +
</p>
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_list</source>
 +
<translate>
 +
<!--T:53-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_list?products=123456,789012&
 +
  filter=%filter%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:54-->
 +
erhalten Sie die Produktliste mit 2 Produkten (123456 und 789012) als Rückgabe.
 +
<h3>Produkt</h3>
 +
<p>Abruf eines einzelnen Produktes mit dem vom Filter zugelassenen Informationen vom Webservice. Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%products_id%)
 
* Produkt ID (%products_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product</source>
+
* Filter (%filter%)
−
<p>'''Example''' für den Artikel 92298A von HP</p>
+
</translate>
−
By accessing:
+
<source lang="text">https://ws.topdata.de/product</source>
−
<source lang="text">http://ws.cloud.topdata.de/product/145080?
+
<translate>
 +
<!--T:17-->
 +
<p>'''Beispiel''' für den Artikel 92298A von HP</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product/145080?filter=all&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 164: Zeile 248:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
you receive the following JSON output:
+
<translate>
 +
<!--T:18-->
 +
erhalten Sie folgende JSON Ausgabe:
 +
</translate>
 
<source lang="javascript">
 
<source lang="javascript">
 
{
 
{
Zeile 281: Zeile 368:
 
}
 
}
 
</source>
 
</source>
−
<p>By the [[Webservice_API#Produktliste|Productlist]] the products will be transfered in the same way<br><br></p>
 
  
 +
<translate>
 +
<!--T:19-->
 +
<p>Bei der [[Webservice_API#Produktliste|Produktliste]] werden die Produkte ebenso übergeben.<br><br></p>
 +
</translate>
 +
<translate>
 +
<!--T:55-->
 +
<h4>Filter</h4>
 +
<p>ab Version 103 pflicht</p>
 +
<p>Die Produkteigenschaften lassen sich filtern um die JSON Rückgabe des Webservice zu minimieren. Wenn nicht alle Informationen benötigt werden, kann korrektes Filtern beim umwandeln von JSON in ein Objekt in Ihrer Anwendung sehr viel Zeit sparen.</p>
 +
* Filter (%filter%)
 +
<source lang="text">?filter=all</source>
 +
<p>Folgender Grundfilter steht zur Verfügung "all". Damit wird Grundsätzlich alles zurück gegeben. Wenn Sie nicht alles benötigen können Sie aus der folgenden Tabelle andere Filter benutzen.
 +
Diese lassen sich auch kombiniert übergeben mit komma getrennt.</p>
 +
</translate>
 +
<source lang="text">?filter=specifications,product_alternates</source>
 +
<translate>
 +
<!--T:20-->
 
{| class="wikitable"
 
{| class="wikitable"
−
|+ Legend of unclear variables
+
|+ Legende uneindeutiger Variablen und Filterangaben
−
!Variable!!Description
+
!Variable!!Beschreibung!!Filterkeys
 
|-
 
|-
−
|''reference_oems''||If the product is an alternative, then the OEMs for the corresponding products appear here
+
|''reference_oems''||Falls das Produkt eine Alternative ist, kommen hier die OEMs zu den entsprechenden Produkten||
 
|-
 
|-
−
|''bundle_content_oems''|| If the product is a bundle, then the OEMs for the individual products appear here
+
|''bundle_content_oems''||Falls das Produkt ein Bundle ist, kommen hier die OEMs der Einzelprodukte||
−
 
+
 
|-
 
|-
−
|[[Webservice_API#bundle_content|''bundle_content'']]||Falls If the product is a bundle, then the product IDs for the individual products appear here
+
|''waregroups''||Warengruppen zum Produktes||waregroups
−
 
+
 
|-
 
|-
−
|[[Webservice_API#product_alternates|''product_alternates'']]|| Alternative product IDs for the product
+
|''specifications''||Spezifikationen des Produktes||specifications
−
 
+
 
|-
 
|-
−
|[[Webservice_API#product_is_alternate_of|''product_is_alternate_of'']]|| The product is an alternative of the product IDs indicated
+
|''images''||Bilder zum Produkt||images
 
|-
 
|-
−
|[[Webservice_API#product_accessories|''product_accessories'']]||Zubehör Accessory product IDs for the product
+
|[[Webservice_API#bundle_content|''bundle_content'']]||Falls das Produkt ein Bundle ist, kommen hier die Produkt IDs der Einzelprodukte||bundle_content
 
|-
 
|-
−
|[[Webservice_API#product_same_accessories|''product_same_accessories'']]|| All product IDs with the same accessories for the product
+
|[[Webservice_API#product_alternates|''product_alternates'']]||Alternative Produkt IDs zum Produkt||product_alternates
 
|-
 
|-
−
|[[Webservice_API#product_application_in|''product_application_in'']]|| Product is an accessory of the named product IDs
+
|[[Webservice_API#product_is_alternate_of|''product_is_alternate_of'']]||Produkt ist eine Alternative der genannten Produkt IDs||product_is_alternate_of
 
|-
 
|-
−
|[[Webservice_API#product_same_application_in|''product_same_application_in'']]|| All product IDs with the same parent product which are an accessory for the product
+
|[[Webservice_API#product_variants|''product_variants'']]||Alle Produkte dieser Variantengruppe (ab Version 104)||variants
 
|-
 
|-
−
|''distributors''|| available providers and their article numbers
+
|[[Webservice_API#product_accessories|''product_accessories'']]||Zubehör Produkt IDs zum Produkt||product_accessories
 +
|-
 +
|[[Webservice_API#product_accessories_modify|''product_accessories_modify'']]||Zubehör Produkt IDs zum Produkt (nur durch modifikation) ||product_accessories_modify
 +
|-
 +
|[[Webservice_API#product_same_accessories|''product_same_accessories'']]||Alle Produkt IDs mit dem selben Zubehör zum Produkt||product_same_accessories
 +
|-
 +
|[[Webservice_API#product_application_in|''product_application_in'']]||Produkt ist Zubehör von den genannten Produkt IDs||product_application_in
 +
|-
 +
|[[Webservice_API#product_application_in_modify|''product_application_in_modify'']]||Produkt ist Zubehör von den genannten Produkt IDs (nur durch modifikation)||product_application_in_modify
 +
|-
 +
|[[Webservice_API#product_same_application_in|''product_same_application_in'']]||Alle Produkt IDs mit dem selben Elternprodukt wozu es ein Zubehör ist vom Produkt||product_same_application_in
 +
|-
 +
|''child_extra_infos''||Grundinfos zu den Verknüpften Produkten (Hersteller, Produktname und Kurzbeschreibung) (ab Verion 102)||child_extra_infos
 +
|-
 +
|''distributors''||verfügbare Anbieter und deren Artikelnummern
 
|}<br>
 
|}<br>
 
{| class="wikitable"
 
{| class="wikitable"
−
|+ Access limitations:  
+
|+ Zugangseinschränkungen
 +
!Variable!!Beschreibung
 +
|-
 +
|''images''||Bilder erhalten Sie nur dann, wenn diese für Ihren Zugang aktiviert wurden
 +
|-
 +
|''distributors''||Sie erhalten jeweils nur die Lieferanten, die für Ihren Zugang aktiviert wurden
 +
|}
 +
<h4>iframe</h4>
 +
<p>ab Version 103 verfügbar</p>
 +
<p>Wenn Sie von uns die Option "ifame" für Sie aktiviert ist, erhalten Sie zu jedem Produkt eine iframe URL. Damit können Sie ganz unkompliziert in jedes Ihrer Projekte unsere Produktdaten einbinden.<br>
 +
Anhand von Anpassungen an der iframe URL können Passagen aus dem iframe aktivieren. Der Rest wird automatisch deaktiviert und nicht angezeigt.<br>
 +
Die Produkt ID steht in der URL sowie die Sprache. Diese lassen sich anpassen.<br>
 +
Um das iframe nutzen zu können sind ein User und ein Key nötig (ACHTUNG nicht die Zugangsdaten vom Webservice). Dieses erhalten Sie von uns.<br>
 +
Das iframe lässt sich über ein einfaches iframe html Tag einbinden. Mehr Informationen [https://de.wikipedia.org/wiki/Inlineframe hier].
 +
</p>
 +
* zu aktivierende Blöcke (%activate%)
 +
<p>'''Beispiel (zeigt alles)'''</p>
 +
<source lang="text">http://rohdaten.topdata.de/iframe/123456/de/?user=XXX&key=XXX</source>
 +
<p>'''Beispiel (zeigt nur das Bilderkarussel)'''</p>
 +
<source lang="text">http://rohdaten.topdata.de/iframe/123456/de/?user=XXX&key=XXX&activate=images</source>
  
−
!Variable!!Description
+
{| class="wikitable"
 +
|+ zu aktivierende Blöcke
 +
!Variable!!Beschreibung
 
|-
 
|-
−
|''images''|| You will only receive images if these are activated for your access details
+
|''head''||Seitenkopf (Artikel Kurzbeschreibung)
 
|-
 
|-
−
|''distributors''|| You will only receive suppliers that are activated for your access details
+
|''images''||Bilderkarussel
 +
|-
 +
|''description''||Der Beschreibungsreiter
 +
|-
 +
|''application_in''||Der Einsetzbar in Reiter
 +
|-
 +
|''product_accessories''||Der Zubehörreiter
 +
|-
 +
|''product_same_accessories''||Der Ähnliche Produkte Reiter für Geräte
 +
|-
 +
|''product_same_application_in''||Der Ähnliche Produkte Reiter für Zubehör
 
|}
 
|}
 +
 +
<!--T:21-->
 
<h4>''bundle_content''</h4>
 
<h4>''bundle_content''</h4>
−
<p> Accesses the products contained for a certain bundle product. These are output as a  [[Webservice_API#Produktliste|Productlist]] .
+
<p>Ruft zu einem bestimmten Bundle-Produkt die enthalten Produkte ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
−
The product ID of the bundle is required for this.</p>
+
Dafür ist die Produkt ID des Bundles notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/bundle_content/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/bundle_content/%product_id%</source>
−
By accessing:
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/bundle_content/%product_id%?
+
<!--T:22-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/bundle_content/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 332: Zeile 484:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:23-->
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:24-->
 
<h4>''product_alternates''</h4>
 
<h4>''product_alternates''</h4>
−
<p> Accesses the alternative product for a certain product. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this.</p>
+
<p>Ruft zu einem bestimmten Produkt die Alternativprodukte ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_alternates/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/product_alternates/%product_id%</source>
−
By accessing:
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_alternates/%product_id%?
+
<!--T:25-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_alternates/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 345: Zeile 507:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:26-->
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:27-->
 
<h4>''product_is_alternate_of''</h4>
 
<h4>''product_is_alternate_of''</h4>
−
<p> For a certain alternative product, accesses those products for which it is an alternative.These are output as a  [[Webservice_API#Produktliste|Productlist]] .
+
<p>Ruft zu einem bestimmten Alternativprodukt diejenigen Produkte ab, zu denen es alternativ ist. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
−
The product ID of the bundle is required for this.</p>
+
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_is_alternate_of/%product_id%</source>
+
</translate>
−
<p>'''Example''</p>
+
<source lang="text">https://ws.topdata.de/product_is_alternate_of/%product_id%</source>
−
Bay accessing:
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_is_alternate_of/%product_id%?
+
<!--T:28-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_is_alternate_of/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 359: Zeile 530:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:29-->
 +
erhalten sie die Produktliste als Rückgabe.
 +
 
 +
<h4>''product_variants''</h4>
 +
<p>Ruft zu einem bestimmten Produkt die Variantenprodukte ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben. (ab Version 104)
 +
Dafür ist die Produkt ID notwendig.</p>
 +
* Produkt ID (%product_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_variants/%product_id%</source>
 +
<translate>
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_variants/%product_id%?
 +
  filter=%filter%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:30-->
 
<h4>''product_accessories''</h4>
 
<h4>''product_accessories''</h4>
−
<p> Accesses those products which are an accessory. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this.</p>
+
<p>Ruft zu einem bestimmten Produkt die Zubehörprodukte ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_accessories/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/product_accessories/%product_id%</source>
−
By accessing
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_accessories/%product_id%?
+
<!--T:31-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_accessories/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 372: Zeile 573:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:32-->
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
 
 +
<h4>''product_accessories_modify''</h4>
 +
<p>Ruft zu einem bestimmten Produkt die Zubehörprodukte ab die nur durch modifikation passen. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 +
* Produkt ID (%product_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_accessories_modify/%product_id%</source>
 +
<translate>
 +
 
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_accessories_modify/%product_id%?
 +
  filter=%filter%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
 
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:33-->
 
<h4>''product_same_accessories''</h4>
 
<h4>''product_same_accessories''</h4>
−
<p> Accesses those products for a certain product, which are having the same accessories. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this </p>
+
<p>Ruft zu einem bestimmten Produkt die Produkte ab mit den dem selben Zubehör. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_same_accessories/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/product_same_accessories/%product_id%</source>
−
By accessing
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_same_accessories/%product_id%?
+
<!--T:34-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_same_accessories/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 385: Zeile 619:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:35-->
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:36-->
 
<h4>''product_application_in''</h4>
 
<h4>''product_application_in''</h4>
−
<p> Accesses those products for which it is an accessory. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this.
+
<p>Ruft zu einem bestimmten Produkt die Produkte ab wozu es ein Zubehör ist. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
−
</p>
+
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_application_in/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/product_application_in/%product_id%</source>
−
By accessing:
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_application_in/%product_id%?
+
<!--T:37-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_application_in/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 399: Zeile 642:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned.
+
<translate>
 +
<!--T:38-->
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
 
 +
<h4>''product_application_in_modify''</h4>
 +
<p>Ruft zu einem bestimmten Produkt die Produkte ab wozu es ein Zubehör ist die nur durch modifikation passen. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 +
* Produkt ID (%product_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_application_in_modify/%product_id%</source>
 +
<translate>
 +
 
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_application_in_modify/%product_id%?
 +
  filter=%filter%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
 
 +
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:39-->
 
<h4>''product_same_application_in''</h4>
 
<h4>''product_same_application_in''</h4>
−
<p> Accesses those products which are also an accessory. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this.</p>
+
<p>Ruft zu einem bestimmten Produkt die Produkte ab die genauso ein Zubehör sind. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Produkt ID notwendig.</p>
 
* Produkt ID (%product_id%)
 
* Produkt ID (%product_id%)
−
<source lang="text">http://ws.cloud.topdata.de/product_same_application_in/%product_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/product_same_application_in/%product_id%</source>
−
By accessing
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/product_same_application_in/%product_id%?
+
<!--T:40-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/product_same_application_in/%product_id%?
 +
  filter=%filter%&
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 412: Zeile 688:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
he product list is returned.
+
<translate>
−
<h3>Provider products</h3>
+
<!--T:41-->
−
<p> Accesses the products for a certain provider. These are output as a  [[Webservice_API#Produktliste|Productlist]] . The product ID of the bundle is required for this.</p>
+
erhalten Sie die Produktliste als Rückgabe.
 +
 
 +
<!--T:42-->
 +
<h3>Anbieter Produkte</h3>
 +
<p>Ruft zu einem bestimmten Anbieter die Produkte ab. Diese werden als [[Webservice_API#Produktliste|Produktliste]] zurückgegeben.
 +
Dafür ist die Anbieter ID notwendig. Diese ist z.B. bei einem der Produkte einsehbar.</p>
 
* Anbieter ID (%distributor_id%)
 
* Anbieter ID (%distributor_id%)
−
<source lang="text">http://ws.cloud.topdata.de/distributor/%distributor_id%</source>
+
</translate>
−
<p>'''Example'''</p>
+
<source lang="text">https://ws.topdata.de/distributor/%distributor_id%</source>
−
By accessing
+
<translate>
−
<source lang="text">http://ws.cloud.topdata.de/distributor/%distributor_id%?
+
<!--T:44-->
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/distributor/%distributor_id%?
 +
  filter=%filter%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:45-->
 +
<h3>Produktfinder</h3>
 +
<p>Hier werden die Daten fertig aufbereitet zurück geliefert um diese direkt als Produktfinder zu verwenden.</p>
 +
<h4>''Tinten-Toner Finder''</h4>
 +
<p>Der Tinten Toner Finder dient dafür sein passendes Verbrauchsmaterial zu seinem Drucker zu finden. Das ganze passiert in 2-3 Schritten.</p>
 +
* Drucker-Hersteller (Auswahl Pflicht) ''Schritt 1''
 +
* Drucker-Modellserien (Auswahl Optional) ''Schritt 2''
 +
* Drucker-Typen (Auswahl Optional) ''Schritt 2''
 +
* Drucker-Modelle (Auswahl Pflicht) ''Schritt 3''
 +
* Drucker-Modell Textsuche
 +
<p>'''Drucker-Hersteller'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/finder/ink_toner/brands?
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:46-->
 +
<p>erhalten Sie die Drucker-Hersteller als Rückgabe.</p>
 +
<p>'''Drucker-Modellserien'''</p>
 +
Bei Aufruf von:
 +
* Drucker-Hersteller ID wird benötigt (%brand_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/finder/ink_toner/modelseries?
 +
  brand_id=%brand_id%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:47-->
 +
<p>erhalten Sie die Modellserien als Rückgabe.</p>
 +
<p>'''Drucker-Typen'''</p>
 +
Bei Aufruf von:
 +
* Drucker-Hersteller ID wird benötigt (%brand_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/finder/ink_toner/devicetypes?
 +
  brand_id=%brand_id%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:48-->
 +
<p>erhalten Sie die Drucker-Typen als Rückgabe.</p>
 +
<p>'''Drucker-Modelle'''</p>
 +
Bei Aufruf von:
 +
* Drucker-Hersteller ID wird benötigt (%brand_id%)
 +
* Drucker-Modellserien ID optional benötigt (%modelserie_id%)
 +
* Drucker-Typen ID optional benötigt (%devicetype_id%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/finder/ink_toner/models?
 +
  brand_id=%brand_id%&
 +
  modelserie_id=%modelserie_id%&    //devicetype_id=%devicetype_id%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:49-->
 +
<p>erhalten Sie die Drucker-Modelle als Rückgabe.</p>
 +
<p>Nach auswahl eines Druckers lässt sich das passende Verbrauchsmaterial über [[Webservice_API#product_accessories|product_accessories]] aufrufen.</p>
 +
<p>'''Drucker-Modell Textsuche'''</p>
 +
Bei Aufruf von:
 +
* Suchbegriff wird benötigt (%q%)
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/finder/ink_toner/search?
 +
  q=%q%&
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:50-->
 +
<p>erhalten Sie die Drucker-Modelle als Rückgabe.</p>
 +
<p>Nach auswahl eines Druckers lässt sich das passende Verbrauchsmaterial über [[Webservice_API#product_accessories|product_accessories]] aufrufen.</p>
 +
</translate>
 +
<translate>
 +
<!--T:56-->
 +
<h3>Mapping</h3>
 +
<p>Nutzen Sie das Mapping um schnell unseren Produktbestand mit Ihrem abzugeleichen. So ist es nicht nötig sich alle Produktinfos zu holen.</p>
 +
<h4>OEM</h4>
 +
<p>Sie erhalten alle für Ihren User zugelassenen OEMs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos [[Webservice_API#Produktliste|hier]] </p>
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/match/oem?
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:57-->
 +
<h4>PCD</h4>
 +
<p>Sie erhalten alle für Ihren User zugelassenen PCDs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos [[Webservice_API#Produktliste|hier]] </p>
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/match/pcd?
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:58-->
 +
<h4>EAN</h4>
 +
<p>Sie erhalten alle für Ihren User zugelassenen EANs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos [[Webservice_API#Produktliste|hier]] </p>
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/match/ean?
 +
  uid=%uid%&
 +
  security_key=%security_key%&
 +
  password=%password%&
 +
  version=%version%&
 +
  language=%language%</source>
 +
<translate>
 +
<!--T:59-->
 +
<h4>Lieferanten Artikel-Nr</h4>
 +
<p>Sie erhalten alle für Ihren User zugelassenen Lieferanten Artikel-Nr mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos [[Webservice_API#Produktliste|hier]] </p>
 +
<p>'''Beispiel'''</p>
 +
Bei Aufruf von:
 +
</translate>
 +
<source lang="text">https://ws.topdata.de/match/distributor?
 
   uid=%uid%&
 
   uid=%uid%&
 
   security_key=%security_key%&
 
   security_key=%security_key%&
Zeile 425: Zeile 850:
 
   version=%version%&
 
   version=%version%&
 
   language=%language%</source>
 
   language=%language%</source>
−
the product list is returned
+
<translate>
−
<h2>Code Examples</h2>
+
<!--T:51-->
 +
<h2>Code Beispiele</h2>
 
<h3>PHP</h3>
 
<h3>PHP</h3>
−
For instance the calling of a product:
+
Z.B. für das Abrufen von einem Produkt.
 +
</translate>
 
<source lang="php">
 
<source lang="php">
 
<?php
 
<?php
  
 
//receive data
 
//receive data
−
$data = file_get_contents('http://ws.cloud.topdata.de/product/145080?uid=...&security_key=...&password=..&version=100&language=de');
+
$data = file_get_contents('https://ws.topdata.de/product/145080?uid=...&security_key=...&password=..&version=100&language=de');
 
 
 
//decode json data
 
//decode json data

Aktuelle Version vom 1. Dezember 2020, 08:56 Uhr

Sprachen:
Deutsch • ‎English


Webservice API Grundlagen

Nutzung

Mit dem Zugang zum Webservice haben Sie automatisch unsere Webservice Nutzungsbedingungen verstanden und akzeptiert.

Zugriffe werden geloggt und ausgewertet. Um Zugriffe/Bandbreite sowie Serverkapazitäten zu sparen, wird empfohlen, die Anfragen an den Webservice (soweit es geht), durch Datencaching zu minimieren. Wir behalten uns das Recht vor, Zugänge einzuschränken oder gegebenenfalls auch zu sperren, sollte der Zugriff zum Webservice über ein plausibles Mass hinausgehen.
Zugangsdaten dürfen nicht an Dritte weitergegeben oder öffentlich dargestellt werden.
Für Ihre Zugangsdaten sind bestimmte, vorher vereinbarte, Daten freigegeben.

Datenformat

Die Rückgabe des Webservices erfolgt im JSON Format. Wir haben uns gegen XML entschieden, da JSON inzwischen genauso weit verbreitet ist und gegenüber XML den Overhead reduziert. Mehr Informationen

Zeichencodierung

Die Ausgabe der Daten des Webservices erfolgt in UFT8

Zugang

Der Abruf der Webservice-Daten erfolgt über eine feste HTTP URL. 

https://ws.topdata.de

Für den Zugang zum Webservice werden Zugangsdaten benötigt, die sich wie folgt zusammensetzen:

  • User ID (%uid%)
  • Passwort (%password%)
  • Sicherheitscode (%security_key%)
Die Zugangsdaten müssen bei jedem Aufruf des Webservices als HTTP Request mit übergeben werden. 

?uid=%uid%&security_key=%security_key%&password=%password%

Weiter sind folgende HTTP Request Variablen Pflicht, um eine Antwort vom Webservice zu erhalten 

?uid=%uid%&security_key=%security_key%&password=%password%&version=%version%&language=%language%

API-Version

Sollten Änderungen am Webservice stattfinden, wird eine neue API-Version vergeben, damit Ihre eigene Applikation nicht immer mit geupdatet werden muss. ACHTUNG, Support unsererseits kann nur für die jeweils aktuelle API-Version geleistet werden.

  • Aktuelle APIVersion: 110 
?version=110

Sprache

Die Sprache muss nach ISO 639-1 übergeben werden. 

?language=en

Error Codes

Alle Fehler im Überblick

Fehler Code Fehler Beschreibung
100 Unbekannter Fehler
101 404 - Seite nicht gefunden
102 User ID nicht vorhanden oder nicht valide
103 Sicherheitscode nicht vorhanden oder nicht valide
104 Passwort nicht vorhanden oder nicht valide
105 API-Version nicht vorhanden oder nicht valide
106 Authentifizierung fehlgeschlagen
107 Sprache nicht vorhanden oder nicht valide
108 Template nicht gefunden (Bitte Service informieren)
109 Template Fehler (Bitte Service informieren)
110 Filter nicht vorhanden oder nicht valide
200 Produkt nicht gefunden

Webservice API Funktionen

Meine Produkte

Sie erhalten alle für Ihren Zugang aktivierten Produkte als Produktliste.

https://ws.topdata.de/my_products

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/my_products?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

Meine Produkte nur mit Artikel-Nr.

Sie erhalten alle für Ihren Zugang aktivierten Produkte als Produktliste wo eine Artikel-Nr. eines zugelassenen Anbieters hinterlegt ist.

https://ws.topdata.de/distributor_products

Warengruppen

ruft die kompletten Warengruppen als Liste auf:

https://ws.topdata.de/waregroups

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/waregroups?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie folgende JSON Ausgabe: 

{
    "waregroups": [
        {
            "waregroup_id": 1,
            "parent_waregroup_id": 173,
            "waregroup": "Printmedien"
        },
        {
            "waregroup_id": 3,
            "parent_waregroup_id": 162,
            "waregroup": "Etiketten"
        },
        ...
    ]
}

Produkte

Ruft alle enthalten Produkte zu einer bestimmten Warengruppe ab. Diese werden als Produktliste zurückgegeben. Dafür ist die Warengruppen ID notwendig. Diese erhalten Sie z.B. aus dem Aufruf der Warengruppen oder sie ist bei einem der Produkte hinterlegt

  • Warengruppen ID (%waregroup_id%) 
https://ws.topdata.de/waregroup/%warengroup_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/waregroup/%warengroup_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe

Produktliste

Die Produktliste enthält alle vom Filter zugelassenen Informationen zu den Produkten und wird bei bestimmten Webservice-Aufrufen zurückgegeben. Es gelten die selben Filterangaben wie beim Produkt

Beispiel

{
 
    "page": {
        "count_products": 694,
        "products_per_page": 50,
        "page": 1,
        "available_pages": 14
    },
    "products": [
        ...
    ]
}

Um den Traffic und die Ladezeit gering zu halten, wird die Produktliste immer in mehrere Seiten unterteilt. Die einzelnen Seiten können über eine weitere HTTP Request Variable angesteuert werden:

?page=3

Die Produktliste beinhaltet Informationen über die Anzahl der Seiten, die Anzahl der Produkte, die Anzahl der Produkte pro Seite sowie die aktuell ausgewählte Unterseite.
Die Produkte in der Produktliste werden analog zum Aufruf eines einzelnen Produktes dargestellt.

mehrere Produkte auf einmal abrufen (ab Version 103)

Sie können auch einer Webservice Abfrage mehrere Produkt-IDs übergeben um dazu die Produktliste zu erhalten. Diese werden per Komma getrennten String übergeben. ACHTUNG es sind maxmimal 50 Produkt-IDs zugelassen (mehr werden ignoriert). 

https://ws.topdata.de/product_list

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_list?products=123456,789012&
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste mit 2 Produkten (123456 und 789012) als Rückgabe.

Produkt

Abruf eines einzelnen Produktes mit dem vom Filter zugelassenen Informationen vom Webservice. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%products_id%)
  • Filter (%filter%) 
https://ws.topdata.de/product

Beispiel für den Artikel 92298A von HP

Bei Aufruf von: 

https://ws.topdata.de/product/145080?filter=all&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie folgende JSON Ausgabe: 

{
    "product": {
        "products_id": 145080,
        "creation_date": null,
        "edit_date": null,
        "short_description": "Original Hewlett Packard Toner-Kartusche schwarz (92298A, 98A)",
        "manufacturer": "Hewlett Packard (HP)",
        "name": "",
        "oems": [
            "92298A",
            "98A"
        ],
        "eans": [
            "088698005668"
        ],
        "reference_oems": [
            "1538A003",
            "M2473G/A",
            "LN0XX-AA"
        ],
        "bundle_content_oems": [ ],
        "waregroups": [
            {
                "waregroup_id": 57,
                "waregroup": "Toner-Kartuschen",
                "main_waregroup": true,
                "waregroup_tree": [
                    {
                        "waregroup_id": 157,
                        "waregroup": "Bürobedarf"
                    },
                    {
                        "waregroup_id": 173,
                        "waregroup": "Druckerzubehör"
                    },
                    {
                        "waregroup_id": 199,
                        "waregroup": "Laserdrucker"
                    },
                    {
                        "waregroup_id": 56,
                        "waregroup": "Toner"
                    },
                    {
                        "waregroup_id": 57,
                        "waregroup": "Toner-Kartuschen"
                    }
                ]
            }
        ],
        "specifications": [
            {
                "specification_id": 6,
                "specification": "Seitendeckung",
                "attribute_id": 4521,
                "attribute": "bei 5% Seitendeckung",
                "attribute_synonym": "",
                "count": 1
            },
            ...
        ],
        "images": [
            {
                "type_id": 5,
                "type_id_string": "005",
                "type_key": "image_type_pack_and_product",
                "thumb": {
                    "url": "http://image.cloud.topdata.de/t/145080.jpg",
                    "url_own_filename": "http://image.cloud.topdata.de/t/145080/"
                },
                "normal": {
                    "url": "http://image.cloud.topdata.de/n/145080.jpg",
                    "url_own_filename": "http://image.cloud.topdata.de/n/145080/"
                }
            },
            {
                "type_id": 10,
                "type_id_string": "010",
                "type_key": "image_type_pack",
                "thumb": {
                    "url": "http://image.cloud.topdata.de/t/145080.jpg",
                    "url_own_filename": "http://image.cloud.topdata.de/t/145080/"
                },
                "normal": {
                    "url": "http://image.cloud.topdata.de/n/145080.jpg",
                    "url_own_filename": "http://image.cloud.topdata.de/n/145080/"
                }
            },
            ...
        ],
        "bundle_content": [ ],
        "product_alternates": {
            "ws_list_url": "/product_alternates/145080",
            "products": [
                [
                    145070,
                    ...
                ]
            ]
        },
        "product_is_alternate_of": {
            "ws_list_url": "/product_is_alternate_of/145080",
            "products": [
                [
                    145070,
                    ...
                ]
            ]
        },
        "product_accessories": [ ],
        "product_application_in": [ ],
        "distributors": [ ]
    }
}

Bei der Produktliste werden die Produkte ebenso übergeben.

Filter

ab Version 103 pflicht

Die Produkteigenschaften lassen sich filtern um die JSON Rückgabe des Webservice zu minimieren. Wenn nicht alle Informationen benötigt werden, kann korrektes Filtern beim umwandeln von JSON in ein Objekt in Ihrer Anwendung sehr viel Zeit sparen.

  • Filter (%filter%) 
?filter=all

Folgender Grundfilter steht zur Verfügung "all". Damit wird Grundsätzlich alles zurück gegeben. Wenn Sie nicht alles benötigen können Sie aus der folgenden Tabelle andere Filter benutzen. Diese lassen sich auch kombiniert übergeben mit komma getrennt.

?filter=specifications,product_alternates
Legende uneindeutiger Variablen und Filterangaben
Variable Beschreibung Filterkeys
reference_oems Falls das Produkt eine Alternative ist, kommen hier die OEMs zu den entsprechenden Produkten
bundle_content_oems Falls das Produkt ein Bundle ist, kommen hier die OEMs der Einzelprodukte
waregroups Warengruppen zum Produktes waregroups
specifications Spezifikationen des Produktes specifications
images Bilder zum Produkt images
bundle_content Falls das Produkt ein Bundle ist, kommen hier die Produkt IDs der Einzelprodukte bundle_content
product_alternates Alternative Produkt IDs zum Produkt product_alternates
product_is_alternate_of Produkt ist eine Alternative der genannten Produkt IDs product_is_alternate_of
product_variants Alle Produkte dieser Variantengruppe (ab Version 104) variants
product_accessories Zubehör Produkt IDs zum Produkt product_accessories
product_accessories_modify Zubehör Produkt IDs zum Produkt (nur durch modifikation) product_accessories_modify
product_same_accessories Alle Produkt IDs mit dem selben Zubehör zum Produkt product_same_accessories
product_application_in Produkt ist Zubehör von den genannten Produkt IDs product_application_in
product_application_in_modify Produkt ist Zubehör von den genannten Produkt IDs (nur durch modifikation) product_application_in_modify
product_same_application_in Alle Produkt IDs mit dem selben Elternprodukt wozu es ein Zubehör ist vom Produkt product_same_application_in
child_extra_infos Grundinfos zu den Verknüpften Produkten (Hersteller, Produktname und Kurzbeschreibung) (ab Verion 102) child_extra_infos
distributors verfügbare Anbieter und deren Artikelnummern

Zugangseinschränkungen
Variable Beschreibung
images Bilder erhalten Sie nur dann, wenn diese für Ihren Zugang aktiviert wurden
distributors Sie erhalten jeweils nur die Lieferanten, die für Ihren Zugang aktiviert wurden

iframe

ab Version 103 verfügbar

Wenn Sie von uns die Option "ifame" für Sie aktiviert ist, erhalten Sie zu jedem Produkt eine iframe URL. Damit können Sie ganz unkompliziert in jedes Ihrer Projekte unsere Produktdaten einbinden.
Anhand von Anpassungen an der iframe URL können Passagen aus dem iframe aktivieren. Der Rest wird automatisch deaktiviert und nicht angezeigt.
Die Produkt ID steht in der URL sowie die Sprache. Diese lassen sich anpassen.
Um das iframe nutzen zu können sind ein User und ein Key nötig (ACHTUNG nicht die Zugangsdaten vom Webservice). Dieses erhalten Sie von uns.
Das iframe lässt sich über ein einfaches iframe html Tag einbinden. Mehr Informationen hier.

  • zu aktivierende Blöcke (%activate%)

Beispiel (zeigt alles)

http://rohdaten.topdata.de/iframe/123456/de/?user=XXX&key=XXX

Beispiel (zeigt nur das Bilderkarussel)

http://rohdaten.topdata.de/iframe/123456/de/?user=XXX&key=XXX&activate=images
zu aktivierende Blöcke
Variable Beschreibung
head Seitenkopf (Artikel Kurzbeschreibung)
images Bilderkarussel
description Der Beschreibungsreiter
application_in Der Einsetzbar in Reiter
product_accessories Der Zubehörreiter
product_same_accessories Der Ähnliche Produkte Reiter für Geräte
product_same_application_in Der Ähnliche Produkte Reiter für Zubehör

bundle_content

Ruft zu einem bestimmten Bundle-Produkt die enthalten Produkte ab. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID des Bundles notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/bundle_content/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/bundle_content/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_alternates

Ruft zu einem bestimmten Produkt die Alternativprodukte ab. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_alternates/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_alternates/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_is_alternate_of

Ruft zu einem bestimmten Alternativprodukt diejenigen Produkte ab, zu denen es alternativ ist. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_is_alternate_of/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_is_alternate_of/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten sie die Produktliste als Rückgabe.

product_variants

Ruft zu einem bestimmten Produkt die Variantenprodukte ab. Diese werden als Produktliste zurückgegeben. (ab Version 104) Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_variants/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_variants/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_accessories

Ruft zu einem bestimmten Produkt die Zubehörprodukte ab. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_accessories/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_accessories/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.


product_accessories_modify

Ruft zu einem bestimmten Produkt die Zubehörprodukte ab die nur durch modifikation passen. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_accessories_modify/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_accessories_modify/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_same_accessories

Ruft zu einem bestimmten Produkt die Produkte ab mit den dem selben Zubehör. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_same_accessories/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_same_accessories/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_application_in

Ruft zu einem bestimmten Produkt die Produkte ab wozu es ein Zubehör ist. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_application_in/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_application_in/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.


product_application_in_modify

Ruft zu einem bestimmten Produkt die Produkte ab wozu es ein Zubehör ist die nur durch modifikation passen. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_application_in_modify/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_application_in_modify/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

product_same_application_in

Ruft zu einem bestimmten Produkt die Produkte ab die genauso ein Zubehör sind. Diese werden als Produktliste zurückgegeben. Dafür ist die Produkt ID notwendig.

  • Produkt ID (%product_id%) 
https://ws.topdata.de/product_same_application_in/%product_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/product_same_application_in/%product_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Produktliste als Rückgabe.

Anbieter Produkte

Ruft zu einem bestimmten Anbieter die Produkte ab. Diese werden als Produktliste zurückgegeben. Dafür ist die Anbieter ID notwendig. Diese ist z.B. bei einem der Produkte einsehbar.

  • Anbieter ID (%distributor_id%) 
https://ws.topdata.de/distributor/%distributor_id%

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/distributor/%distributor_id%?
  filter=%filter%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

Produktfinder

Hier werden die Daten fertig aufbereitet zurück geliefert um diese direkt als Produktfinder zu verwenden.

Tinten-Toner Finder

Der Tinten Toner Finder dient dafür sein passendes Verbrauchsmaterial zu seinem Drucker zu finden. Das ganze passiert in 2-3 Schritten.

  • Drucker-Hersteller (Auswahl Pflicht) Schritt 1
  • Drucker-Modellserien (Auswahl Optional) Schritt 2
  • Drucker-Typen (Auswahl Optional) Schritt 2
  • Drucker-Modelle (Auswahl Pflicht) Schritt 3
  • Drucker-Modell Textsuche

Drucker-Hersteller

Bei Aufruf von: 

https://ws.topdata.de/finder/ink_toner/brands?
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Drucker-Hersteller als Rückgabe.

Drucker-Modellserien

Bei Aufruf von:

  • Drucker-Hersteller ID wird benötigt (%brand_id%) 
https://ws.topdata.de/finder/ink_toner/modelseries?
  brand_id=%brand_id%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Modellserien als Rückgabe.

Drucker-Typen

Bei Aufruf von:

  • Drucker-Hersteller ID wird benötigt (%brand_id%) 
https://ws.topdata.de/finder/ink_toner/devicetypes?
  brand_id=%brand_id%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Drucker-Typen als Rückgabe.

Drucker-Modelle

Bei Aufruf von:

  • Drucker-Hersteller ID wird benötigt (%brand_id%)
  • Drucker-Modellserien ID optional benötigt (%modelserie_id%)
  • Drucker-Typen ID optional benötigt (%devicetype_id%) 
https://ws.topdata.de/finder/ink_toner/models?
  brand_id=%brand_id%&
  modelserie_id=%modelserie_id%&    //devicetype_id=%devicetype_id%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Drucker-Modelle als Rückgabe.

Nach auswahl eines Druckers lässt sich das passende Verbrauchsmaterial über product_accessories aufrufen.

Drucker-Modell Textsuche

Bei Aufruf von:

  • Suchbegriff wird benötigt (%q%) 
https://ws.topdata.de/finder/ink_toner/search?
  q=%q%&
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

erhalten Sie die Drucker-Modelle als Rückgabe.

Nach auswahl eines Druckers lässt sich das passende Verbrauchsmaterial über product_accessories aufrufen.

Mapping

Nutzen Sie das Mapping um schnell unseren Produktbestand mit Ihrem abzugeleichen. So ist es nicht nötig sich alle Produktinfos zu holen.

OEM

Sie erhalten alle für Ihren User zugelassenen OEMs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos hier

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/match/oem?
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

PCD

Sie erhalten alle für Ihren User zugelassenen PCDs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos hier

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/match/pcd?
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

EAN

Sie erhalten alle für Ihren User zugelassenen EANs mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos hier

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/match/ean?
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

Lieferanten Artikel-Nr

Sie erhalten alle für Ihren User zugelassenen Lieferanten Artikel-Nr mit dazugehöriger Produkt-ID. Sie erhalten diese in 1000er Blöcken. Mit "page" können Sie diese durchgehen. Mehr infos hier

Beispiel

Bei Aufruf von: 

https://ws.topdata.de/match/distributor?
  uid=%uid%&
  security_key=%security_key%&
  password=%password%&
  version=%version%&
  language=%language%

Code Beispiele

PHP

Z.B. für das Abrufen von einem Produkt. 

<?php
 
	//receive data
	$data = file_get_contents('https://ws.topdata.de/product/145080?uid=...&security_key=...&password=..&version=100&language=de');
 
	//decode json data
	$json = json_decode($data);
 
	//display json object
	var_dump($json);
 
?>
Von „http://wiki.cloud.topdata.de/index.php?title=Webservice_API&oldid=383“