Product List API

Die Product List API ermöglicht den Abruf einer vollständigen Produktliste für den eigenen Vendor Account. Mögliche Anwendungsfälle sind zum Beispiel Produktlisten auf Ihrer Verkaufsseite.

Die Daten müssen auf Ihrer Seite zwischengespeichert (gecached) werden, wir behalten uns vor den Abruf der Daten per API mit einem sogenannten Throttling vor zu häufigen Anfragen einzuschränken.

1. Voraussetzungen

Definition eines Secret Keys in den Account-Einstellungen im MY-Bereich

Für die Autentifizierung der Anfrage an die API ein Secret-Key genutzt werden. Diesen generieren Sie in Ihrem MY-Bereich per Klick auf Ihren Vendor-Namen → Account-Einstellungen → API → Secret-Key → Generieren.

2. Aufruf

Der Aufruf an die Product List API ist ein einfacher GET-Request:

https://secure.affilibank.de/[vendor name]/getproducts

Im HEAD des Request muss der obige Secret Key mitgeliefert werden:

X-API-KEY=[ihr api key]

3. Verschlüsselung der zu übermittelnden Daten

Die mitgesendeten Daten im Parameter "prefill" müssen verschlüsselt werden, weil GET-Requests geloggt werden und aber auch von außerhalb abgreifbar sind. Die Verschlüsselung erfolgt mittels Blowfish und dem Secret-Key (Punkt 1.1).

Beispiel PHP + CURL request

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.affilibank.de/demo-account-affilicon/getproducts',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'X-API-KEY: DEMO_API_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

4. Response

Der JSON Response sieht dann je nach konfigurierten Produkten beispielsweise so aus:

Response

{
    "13987": {
        "price": 19.899999999999999,
        "pricing_net": false,
        "image_url": "https://fd897.s3-eu-central-1.amazonaws.com/images/jtw9celoug0ggcog4ccccsggscw4go0.jpg",
        "texts": {
            "de_DE": {
                "title": "Physisches Produkt simpel (z.B. Buch, Kaffeetasse)",
                "description": "Dies ist ein physisches Produkt, welches auf postalischem Wege zum Kunden geschickt wird. "
            }
        },
        "shipping": {
            "europe1": {
                "base": 3.8999999999999999
            }
        }
    },
    "13988": {
        "price": 24.899999999999999,
        "pricing_net": false,
        "image_url": "https://fd897.s3-eu-central-1.amazonaws.com/images/r36uo2ly85wo08oso8gkcswcgwkogso.jpg",
        "texts": {
            "de_DE": {
                "title": "Digitales Produkt (z.B. eBook, PDF)",
                "description": "Dies ist ein digitales Produkt, welches den Kunden per Download zur Verfügung gestellt wird. Der Kunde kann direkt nach dem Kauf auf das Produkt zugreifen."
            }
        }
    },
    "13989": {
        "price": 198,
        "pricing_net": false,
        "image_url": "https://fd897.s3-eu-central-1.amazonaws.com/images/bmtfodbaoi880cg4c80ck04ck0go4sg.jpg",
        "texts": {
            "de_DE": {
                "title": "Seminar mit Ticket-Versand (z.B. Business Coaching)",
                "description": "Hierbei handelt es sich um ein Seminar, Coaching oder eine andere Veranstaltung. Im Anschluss an den Kauf erhält der Kunde sofort sein eTicket zur Veranstaltung per Email. Das Design des Tickets können Sie nach Ihren Vorlieben anpassen."
            }
        }
    }
}