 | PUBLISHER | ADVERTISER | AGENTUREN | PARTNERPROGRAMME | APPS & APIS | PRESSE | ÜBER UNS |
SmartFeed SOAP-WebServices V1.4.1
1 Inhaltsverzeichnis
2 Einleitung
Die belboon WebServices (SOAP-Protokoll) ermöglichen es Ihnen automatisiert mit unserem Affiliate-Netzwerk zu arbeiten ohne dass Sie sich über die Web-Oberfläche in Ihr Account einloggen müssen.
Mit den belboon SmartFeeds-WebService API können Sie vollautomatisiert auf die Produktdaten der belboon-Merchants zugreifen.
Mehr als 500 Online-Shops bieten Ihnen mehrere Millionen Produktdaten-Sätze über die belboon-Produktdatenbank an. Damit Sie Zugriff auf die Produktdaten der jeweiligen Anbieter bekommen, müssen Sie sich zuerst bei den entsprechenden Partnerprogrammen bewerben.
Eine komprimierte Übersicht über alle Anbieter mit Produktdaten finden Sie im Menu-Punkt „Produktdaten > Übersicht Produktdaten".
Sie können die SmartFeeds-WebServices dazu nutzen um Produktdaten, Kategorie-Strukturen einzelner Online-Shops Produkt-Suchergebnisse und vieles mehr herunter zu laden.
SmartFeeds-WebService-URL: http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl
3 Generieren eines Webservice-Passworts
Die SmartFeeds-Webservices ermöglichen es Ihnen, auch ohne Account-Login auf die Produktdaten der belboon-Merchants zu zugreifen.
Im Menu-Punkt „Tools & Services > Webservices" finden Sie die Möglichkeit, Ihr Webservice-Passwort initial zu generieren. Danach werden Sie dies an dieser Stelle stets nachlesen können.
Der Usernamen für die Nutzung der Webservices ist identisch mit Ihrem Affiliate-Account-Benutzernamen.
4 SmartFeeds-Webservices
4.1 Result-Object
Beim Aufruf einer Funktion des Webservices werden die Daten über ein einheitliches Result-Object zurück geliefert. Dieses Objekt enthält einige Metadaten wie z.B. Fehlermeldungen und ein Array mit den angefragten Daten.
Result-Object
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
|
hasError |
Boolean |
Zeigt an, ob Fehler vorliegt true/false |
|
ErrorMsg |
String |
Ggf. Fehlermeldung |
|
NumRecords |
Integer |
Anzahl der Zeilen im Result-Array |
|
NumRecordsTotal |
Integer |
Anzahl der gesamt vorhandenen Zeilen zu der Anfrage |
|
Records |
Array() |
Liste der angeforderten Objekte |
4.2 Config-Array
Einigen Funktionsaufrufen kann neben dem SessionHash und ggf. einem Suchbegriff ein Array mit Konfigurationsparametern übergeben werden. Mit Hilfe dieses Arrays können diverse Filtereinstellungen festgelegt werden. Welche Werte in diesem Array übergeben werden können, entnehmen Sie bitte den Beschreibungen der einzelnen Funktionen.
| Key | Typ | Default/span> | Beschreibung |
|---|---|---|---|
|
platforms |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf Partnerschaften dieser Werbeplattform-IDs ein |
|
feeds |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf Feeds mit diesen Ids ein |
|
offset |
Integer |
0 |
Listet Suchergebnisse erst ab diesem Wert |
|
limit |
Integer |
Null |
Begrenzt Suchergebnisse auf max-Wert |
|
updated_after |
Date |
1970-0-0 |
Liefert Datensätze, die nach dem angegeben Datum aktualisiert wurden |
|
categories |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf die angegebenen belboon-Kategorien ein. |
|
sort |
String[] |
array(„belboon_productnumber" => „ASC") |
Sortiert die Rückgabe von Produktdaten (bei Produktsuche oder Rückgabe eines Feeds) nach dem übergebenen Spaltennamen mit gewünschter Orientierung (ASC = aufsteigend, DESC= absteigend) |
|
price_min |
float |
0.00 |
untere Preisgrenze |
|
price_max |
float |
999999.99 |
obere Preisgrenze |
|
categories |
Integer[] (Array) |
Null |
Schränkt die Ergebnisse auf Kategorien mit den übergebenen IDs ein. |
|
with_subcategories |
Boolean |
True |
Berücksichtigt beim Kategorie-Filter auch die Unterkategorien. Standardmäßig aktiviert. |
4.3 Einzelne Funktionsdienste
4.3.1 Session / Authentifizierung
4.3.1.1 login (username, password)
Liefert einen Session Hash Wert [String()]zurück, der 30Minuten gültig ist, wobei der Ablauf der 30 Minuten mit jeder neuen Aktion / Abfrage neu beginnt. Bei den einzelnen Abfragen ist dieser Session Hash als Authentifizierung mitzuliefern.
Request
| Parameter | Typ | Beschreibung |
|---|---|---|
|
username |
String |
Username / Login |
|
password |
String |
Passwort für Webservices |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionHash |
String |
Session Hash, der als Identifikation für weitere Aufrufe der Sessions in den nachfolgenden Aufrufen verwendet wird |
Beispiel:
|
<?php define ("WSDL_SERVER",
"http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed=new SoapClient(WSDL_SERVER); $oSessionHash=$oSmartFeed->login('YourLoginName', 'YourPassword');
if(!$oSessionHash->HasError){
$sSessionHash=$oSessionHash->Records['sessionHash']; } |
4.3.2 Partnerschaftsdaten
4.3.2.1 getPlatforms (SessionHash)
Liefert eine Liste (Array) aller Werbeplattformen des eigenen Accounts.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
id |
Integer |
Werbeplattform-ID |
|
name |
String |
Name der Werbeplattform |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash=$oSessionHash->Records['sessionHash']; $aResult=$oSmartFeed->getPlatforms($sSessionHash); var_dump($aResult); } |
4.3.2.2 getFeeds (SessionHash, [config])
Liefert eine Liste (Array) aller Produktdatenwerbemittel der Programme, mit denen eine Partnerschaft besteht, ggf. eingeschränkt durch Filter.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
[config] |
Array |
Config Array, optional |
Config-Array
| Key | Typ | Default/span> | Beschreibung |
|---|---|---|---|
|
offset |
Integer |
0 |
Listet Suchergebnisse erst ab diesem Wert |
|
limit |
Integer |
Null |
Begrenzt die Anzahl der Ergebnisse auf diesen max-Wert |
|
platforms |
Integer[] (Array) |
|
Begrenzt die Auswahl der Feeds auf die Programme, die mit der angegebenen Plattform eine Partnerschaft haben |
|
sort |
String[] |
array(„belboon_productnumber" => „ASC") |
Sortiert die Rückgabe von Produktdaten (bei Produktsuche oder Rückgabe eines Feeds) nach dem übergebenen Spaltennamen mit gewünschter Orientierung (ASC = aufsteigend, DESC= absteigend) |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
id |
Integer |
Werbemittel-ID des Produktdatenfeeds |
|
name |
String |
Name des Werbemittels |
|
product_count |
Integer |
Anzahl der Produkte |
|
last_update |
String (YYYY-MM-DD HH:mm:ss) |
Letzte Aktualisierung |
|
program_name |
String |
Name des Partnerprogramms |
|
url |
String |
Shop URL |
|
logo_url |
String |
URL zum Shoplogo |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $aResult= $oSmartFeed->getFeeds($sSessionHash); var_dump($aResult); } |
4.3.3 Produkt-Daten
4.3.3.1 getProductData (SessionHash, [config])
Liefert eine Liste (Array) aller Produktdaten, ggf. eingeschränkt durch Filter.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
[config] |
Array |
Config Array, optional |
Config-Array
| Key | Typ | Default/span> | Beschreibung |
|---|---|---|---|
|
platforms |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf Partnerschaften dieser Werbeplattform-IDs ein |
|
feeds |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf Produkte der Feeds mit diesen Ids ein |
|
offset |
Integer |
0 |
Listet Suchergebnisse erst ab diesem Wert |
|
limit |
Integer |
Null |
Begrenzt Suchergebnisse auf max-Wert |
|
updated_after |
Date |
1970-0-0 |
Liefert Datensätze, die nach dem angegeben Datum aktualisiert wurden |
|
sort |
String[] |
array(„belboon_productnumber" => „ASC") |
Sortiert die Rückgabe von Produktdaten (bei Produktsuche oder Rückgabe eines Feeds) nach dem übergebenen Spaltennamen mit gewünschter Orientierung (ASC = aufsteigend, DESC= absteigend) |
|
categories |
Integer[] (Array) |
Null |
Schränkt die Ergebnisse auf Kategorien mit den übergebenen Kategorie-IDs ein. *nicht alle vorhandenen Produktdaten sind einer belboon-Kategorie zugeordnet |
|
with_subcategories |
Boolean |
True |
Berücksichtigt beim Kategorie-Filter auch die Unterkategorien. Standardmäßig aktiviert (=TRUE). |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
feed_id |
Integer |
ID des Produktdaten-Feeds |
|
belboon_productnumber |
String |
belboon Produkt-ID |
|
belboon_programid |
String |
Programm-ID |
|
productnumber |
String |
Produktnummer des Merchants |
|
ean |
String |
EAN-Code |
|
productname |
String |
Name des Produkts |
|
manufacturername |
String |
Hersteller des Produkts |
|
brandname |
String |
Marke des Produkts |
|
currentprice |
String |
Preis |
|
oldprice |
String |
Alter Preis |
|
currency |
String |
Währung |
|
validfrom |
String |
Beginn der Gültigkeit des Angebotes |
|
validuntil |
String |
Ende der Gültigkeit des Angebotes |
|
deeplinkurl |
String |
URL zum Produkt |
|
basketurl |
String |
URL zum Ablegen des Produkts im Warenkorb |
|
imagesmallurl |
String |
URL zum "kleinen" Produktbild |
|
imagesmallheight |
Integer |
Höhe des "kleinen" Produktbildes |
|
imagesmallwidth |
Integer |
Breite des "kleinen" Produktbildes |
|
imagebigurl |
String |
URL zum "großen" Produktbild |
|
imagebigheight |
Integer |
Höhe des "großen" Produktbildes |
|
imagebigwidth |
Integer |
Breite des "großen" Produktbildes |
|
productcategory |
String |
Produktkategorie des Merchants |
|
belboonproductcategory |
String |
belboon- Produktkategorie |
|
productkeywords |
String |
Keywords |
|
productdescriptionshort |
String |
Kurzbeschreibung des Produkts |
|
productdescriptionlong |
String |
ausführliche Beschreibung des Produkts |
|
Lastupdate |
String |
Letztes Update des Produkts (durch Merchant angegeben) |
|
shipping |
String |
Versandkosten des Produkts |
|
availability |
String |
Verfügbarkeit des Produkts |
|
option1 |
String |
Optionales Feld / Zusatzinformationen |
|
option2 |
String |
Optionales Feld / Zusatzinformationen |
|
option3 |
String |
Optionales Feld / Zusatzinformationen |
|
option4 |
String |
Optionales Feld / Zusatzinformationen |
|
option5 |
String |
Optionales Feld / Zusatzinformationen |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $aConfig= array('limit'=>5, 'offset'=>2); $aResult= $oSmartFeed-> getProductData ($sSessionHash, $aConfig); var_dump($aResult); } |
4.3.3.2 getFeedUpdate (SessionHash, FeedId)
Liefert den Zeitpunkt des letzten Updates eines Feeds durch den Merchant.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
FeedId |
Integer |
FeedId des Datensatzes, dessen letztes Update geliefert werden soll. |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
last_update |
Date |
Letztes Update durch den Merchant |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $aResult= $oSmartFeed-> getFeedUpdateDate($sSessionHash, FeedId); var_dump($aResult); } |
4.3.3.3 searchProducts (SessionHash, Query, [config])
Liefert eine Liste (Array) von Produktdaten, die auf den Suchbegriff und den config Filter zutreffen
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
query |
String |
Suchbegriff |
|
[config] |
Array |
Config Array, optional |
Config-Array
| Key | Typ | Default/span> | Beschreibung |
|---|---|---|---|
|
platforms |
Integer |
Null |
Schränkt Ergebnisse auf Partnerschaften dieser Werbeplattform-ID ein |
|
feeds |
Integer[] (Array) |
Null |
Schränkt Ergebnisse auf Produkte der Feeds mit diesen Ids ein |
|
offset |
Integer |
0 |
Listet Suchergebnisse erst ab diesem Wert |
|
limit |
Integer |
Null |
Begrenzt Suchergebnisse auf max-Wert |
|
updated_after |
Date |
1970-0-0 |
Liefert Datensätze, die nach dem angegeben Datum aktualisiert wurden |
|
sort |
String[] |
array(„belboon_productnumber" => „ASC") |
Sortiert die Rückgabe von Produktdaten (bei Produktsuche oder Rückgabe eines Feeds) nach dem übergebenen Spaltennamen mit gewünschter Orientierung (ASC = aufsteigend, DESC= absteigend) |
|
price_min |
float |
0.00 |
untere Preisgrenze |
|
price_max |
float |
999999.99 |
obere Preisgrenze |
|
categories |
Integer[] (Array) |
Null |
Schränkt die Ergebnisse auf Kategorien mit den übergebenen Kategorie-IDs ein. *nicht alle vorhandenen Produktdaten sind einer belboon-Kategorie zugeordnet |
|
with_subcategories |
Boolean |
True |
Berücksichtigt beim Kategorie-Filter auch die Unterkategorien. Standardmäßig aktiviert (=TRUE). |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
feed_id |
Integer |
ID des Produktdaten-Feeds |
|
belboon_productnumber |
String |
belboon Produkt-ID |
|
belboon_programid |
String |
Programm-ID |
|
productnumber |
String |
Produktnummer des Merchants |
|
ean |
String |
EAN-Code |
|
productname |
String |
Name des Produkts |
|
manufacturername |
String |
Hersteller des Produkts |
|
brandname |
String |
Marke des Produkts |
|
currentprice |
String |
Preis |
|
oldprice |
String |
Alter Preis |
|
currency |
String |
Währung |
|
validfrom |
String |
Beginn der Gültigkeit des Angebotes |
|
validuntil |
String |
Ende der Gültigkeit des Angebotes |
|
deeplinkurl |
String |
URL zum Produkt |
|
basketurl |
String |
URL zum Ablegen des Produkts im Warenkorb |
|
imagesmallurl |
String |
URL zum "kleinen" Produktbild |
|
imagesmallheight |
Integer |
Höhe des "kleinen" Produktbildes |
|
imagesmallwidth |
Integer |
Breite des "kleinen" Produktbildes |
|
imagebigurl |
String |
URL zum "großen" Produktbild |
|
imagebigheighti |
Integer |
Höhe des "großen" Produktbildes |
|
imagebigwidth |
Integer |
Breite des "großen" Produktbildes |
|
productcategory |
String |
Produktkategorie des Merchants |
|
belboonproductcategory |
String |
belboon-Kategorie |
|
productkeywords |
String |
Keywords |
|
productdescriptionshort |
String |
Kurzbeschreibung des Produkts |
|
productdescriptionlong |
String |
ausführliche Beschreibung des Produkts |
|
lastupdate |
String |
Letztes Update des Produkts (durch Merchant angegeben) |
|
shipping |
String |
Versandkosten des Produkts |
|
availability |
String |
Verfügbarkeit des Produkts |
|
option1 |
String |
Optionales Feld / Zusatzinformationen |
|
option2 |
String |
Optionales Feld / Zusatzinformationen |
|
option3 |
String |
Optionales Feld / Zusatzinformationen |
|
option4 |
String |
Optionales Feld / Zusatzinformationen |
|
option5 |
String |
Optionales Feld / Zusatzinformationen |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $aConfig= array('limit'=>5, 'offset'=>2); $sSearch= 'ipod'; $aResult=$oSmartFeed->searchProducts($sSessionHash,$sSearch,$aConfig); var_dump($aResult); } |
4.3.3.4 getProductById (SessionHash,productId)
Liefert eine die Daten eines Produkts mit der Abgefragten belboon-Produkt-ID zuück.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
ProductId |
String |
belboon-Produktnummer |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
feed_id |
Integer |
ID des Produktdaten-Feeds |
|
belboon_productnumber |
String |
belboon Produkt-ID |
|
belboon_programid |
String |
Programm-ID |
|
productnumber |
String |
Produktnummer des Merchants |
|
ean |
String |
EAN-Code |
|
productname |
String |
Name des Produkts |
|
manufacturername |
String |
Hersteller des Produkts |
|
brandname |
String |
Marke des Produkts |
|
currentprice |
String |
Preis |
|
oldprice |
String |
Alter Preis |
|
currency |
String |
Währung |
|
validfrom |
String |
Beginn der Gültigkeit des Angebotes |
|
validuntil |
String |
Ende der Gültigkeit des Angebotes |
|
deeplinkurl |
String |
URL zum Produkt |
|
basketurl |
String |
URL zum Ablegen des Produkts im Warenkorb |
|
imagesmallurl |
String |
URL zum "kleinen" Produktbild |
|
imagesmallheight |
Integer |
Höhe des "kleinen" Produktbildes |
|
imagesmallwidth |
Integer |
Breite des "kleinen" Produktbildes |
|
imagebigurl |
String |
URL zum "großen" Produktbild |
|
imagebigheighti |
Integer |
Höhe des "großen" Produktbildes |
|
imagebigwidth |
Integer |
Breite des "großen" Produktbildes |
|
productcategory |
String |
Produktkategorie des Merchants |
|
belboonproductcategory |
String |
belboon-Kategorie |
|
productkeywords |
String |
Keywords |
|
productdescriptionshort |
String |
Kurzbeschreibung des Produkts |
|
productdescriptionlong |
String |
ausführliche Beschreibung des Produkts |
|
lastupdate |
String |
Letztes Update des Produkts (durch Merchant angegeben) |
|
shipping |
String |
Versandkosten des Produkts |
|
availability |
String |
Verfügbarkeit des Produkts |
|
option1 |
String |
Optionales Feld / Zusatzinformationen |
|
option2 |
String |
Optionales Feld / Zusatzinformationen |
|
option3 |
String |
Optionales Feld / Zusatzinformationen |
|
option4 |
String |
Optionales Feld / Zusatzinformationen |
|
option5 |
String |
Optionales Feld / Zusatzinformationen |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $oResult = $oSmartFeed->getProductById($sSessionHash, '1_3_37'); var_dump($oResult); }
|
4.3.3.5 searchProductsByEan (SessionHash, EAN, [config])
Liefert eine Liste (Array) von Produktdaten, die auf die übergebene EAN und den config Filter zutreffen. Request- und Result-Objekt entsprechen denen von searchProducts().
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
ean |
String |
EAN-Nummer (nicht immer in den Produktdaten vorhanden) |
|
[config] |
Array |
Config Array, optional |
Config-Array und Response-Parameter analog zu 4.3.3.3 searchProducts (SessionHash, Query, [config]).
4.3.3.6 getCategory($sSessionHash, $iCategoryId)
Liefert anhand einer ID eine Produktdaten-Kategorie als Array.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
id |
Integer |
Kategorie-ID |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
id |
Integer |
Kategorie-ID |
|
parent_id |
Integer |
ID der Eltern-Kategorie |
|
name |
String |
Name der Kategorie |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $oResult= $oSmartFeed->getCategory($sSessionHash, CategoryId); var_dump($oResult->Records); } |
4.3.3.7 getCategories($sSessionHash, $aConfig)
Liefert ein Array mit den Kategorien der Produktdaten, die auf die Einschränkungen des Config-Arrays zutreffen.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
[config] |
Array |
Config Array, optional |
Config-Array
| Key | Typ | Default/span> | Beschreibung |
|---|---|---|---|
|
offset |
Integer |
0 |
Listet Suchergebnisse erst ab diesem Wert |
|
limit |
Integer |
Null |
Begrenzt Suchergebnisse auf max-Wert |
|
parent_id |
Integer |
Null |
Liefert nur die Kategorien mit der übergebenen |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
id |
Integer |
Kategorie-ID |
|
parent_id |
Integer |
ID der Eltern-Kategorie |
|
name |
String |
Name der Kategorie |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; $oResult= $oSmartFeed->getCategories($sSessionHash); var_dump($oResult->Records); } |
4.3.3.8 getCategoryPath($sSessionHash, $iCategoryId)
Liefert eine Liste (Array) von Kategorien, die den Pfad zu der übergebenen Kategorie beschreiben.
Request-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
|
id |
Integer |
Kategorie-ID |
Response-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
|
id |
Integer |
Kategorie-ID |
|
name |
String |
Name der Kategorie |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash=$oSessionHash->Records['sessionHash']; $oResult= $oSmartFeed->getCategories($sSessionHash); foreach ($oResult->Records AS $aRecord) { $oResultPath= $oSmartFeed->getCategoryPath($sSessionHash, $aRecord['id']); foreach ($oResultPath->Records AS $aElem) { echo " > ". $aElem['name'] . " (". $aElem['id'].")"; } } } |
4.3.3.9 logout (sessionHash)
Beendet die aktuelle Session.
Request
| Parameter | Typ | Beschreibung |
|---|---|---|
|
sessionhash |
String |
SessionHash zur Identifizierung |
Beispiel:
|
<?php define ("WSDL_SERVER", "http://smartfeeds.belboon.com/SmartFeedServices.php?wsdl"); $oSmartFeed= new SoapClient(WSDL_SERVER); $oSessionHash= $oSmartFeed->login('YourLoginName', 'YourPassword'); if(!$oSessionHash->HasError){ $sSessionHash= $oSessionHash->Records['sessionHash']; ... $oSmartFeed->logout($sSessionHash); } |
5 Änderungshistorie (change-log)
Änderungen von V.1.3 zu V.1.4
- Erweiterung des Response-Parameters der Funktion „getFeeds“ um die Parameter „product_count“, „last_update“ und „program_name“
Änderungen von V.1.2 zu V.1.3
- Funktion „getProductById" neu hinzugefügt
Änderungen von V.1.1 zu V.1.2
- Funktion „getProductData"-Responseparameter: „belboon_programmid" korrigiert in „belboon_programid"
- Funktion „getProductData"-Config-Array: {categories} und {with_categories} hinzugefügt
- Funktionen „searchProducts"-Config-Array: Keys {price_min}, {price_max}, {categories} und {with_categories} hinzugefügt
- Funktionen „searchProductsByEan"-Config-Array: Keys {price_min}, {price_max}, {categories} und {with_categories} hinzugefügt
- Funktion „searchProducts"- Responseparameter: „belboon_programmid" korrigiert in „belboon_programid"
- Funktion „getFeedUpdate" neu hinzugefügt
- Funktion „getCategory" neu hinzugefügt
- Funktion „getCategories" neu hinzugefügt
- Funktion „getCategoryPath" neu hinzugefügt
Änderungen von V.1.0 zu V.1.1
- Results-Object: „NumRecordsTotal" als Response-Parameter hinzugefügt
- Funktion „getProductsByEan" neu hinzugefügt
Anhänge:
Handbuch SmartFeeds Webservices V1.4.1 - (Size 683kb)
Jetzt registrieren!
Werden Sie Teil unserer einzigartigen Erfolgsgeschichte
Publisher: registrieren
Tel: 0049 (0)30-72 61 62 320
Fax: 0049 (0)30-72 61 62 311
Email: info@belboon.de
Advertiser: mehr
belboon-adbutler GmbH
Karl-Liebknecht-Str. 1
10178 Berlin
Deutschland
Tel: 0049 (0)30 72 61 62-320
Fax: 0049 (0)30 72 61 62-311
Email: info@belboon.de
Handelsregister:
AG Berlin (Charlottenburg), HRB 125210
USt-ID: DE220719614
Geschäftsführer: Manuel Kester
SVEN POHLMANN
boniad Medienagentur
"Schon nach kurzer Zeit hat sich das Partnernetzwerk belboon bei uns zur absoluten Nummer 1 entwickelt. Die gute Programmauswahl, attraktive Werbemittel und die kompetente Betreuung der Affiliates haben uns überzeugt. [...]"
A YOC Group Company
