EDD REST API – Kunden

Die
EDD REST API bietet einen Endpunkt namens /customers/. Der Kundenendpunkt ermöglicht es Ihnen, die Datenbank abzufragen und eine Liste von Kunden abzurufen, die Artikel in Ihrem Shop gekauft haben. Eine einfache Kundenabfrage sieht wie folgt aus:

https://yoursite.com/edd-api/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&number=25

Für jeden zurückgegebenen Kunden werden die folgenden Informationen für jeden Kunden zurückgegeben:

• id – Die WordPress-Benutzer-ID. Wenn der Kunde als Gast gekauft hat, wird hier -1 zurückgegeben.
• username – Der WordPress-Benutzer-Loginname. Wenn der Kunde als Gast gekauft hat, wird hier nichts zurückgegeben.
• display_name – Der angezeigte Name des WordPress-Benutzers. Wenn der Kunde als Gast gekauft hat, wird hier nichts zurückgegeben.
• first_name – Der Vorname des Kunden.
• last_name – Der Nachname des Kunden.
• email – Die E-Mail-Adresse des Kunden.
• total_purchases – Die Gesamtzahl der Käufe, die der Kunde getätigt hat.
• total_spent – Der Gesamtbetrag, den der Kunde ausgegeben hat.
• total_downloads – Die Gesamtzahl der Dateien, die der Kunde heruntergeladen hat.

Zusammen mit den für jeden Kunden zurückgegebenen Daten gibt es ein
stats-Objekt, das die Gesamtzahl der Kunden in der Datenbank anzeigt.

Eine Kundenabfrageantwort sieht wie folgt aus:

{
    "customers": [
        {
            "info": {
                "id": -1,
                "username": "Guest",
                "display_name": "Guest",
                "first_name": "Guest",
                "last_name": "Guest",
                "email": "[email protected]"
            },
            "stats": {
                "total_purchases": 2,
                "total_spent": "20",
                "total_downloads": 0
            }
        },
        {
            "info": {
                "id": -1,
                "username": "Guest",
                "display_name": "Guest",
                "first_name": "Guest",
                "last_name": "Guest",
                "email": "[email protected]"
            },
            "stats": {
                "total_purchases": 0,
                "total_spent": "0",
                "total_downloads": 0
            }
        }
    ]
}

Wenn Sie die Informationen für einen bestimmten Kunden abrufen möchten, können Sie den
&customer={identifier}-Parameter hinzufügen, wie hier:

https://yoursite.com/edd-api/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&customer=1

oder

https://yoursite.com/edd-api/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&[email protected]

Die Antwort für einen einzelnen Kunden wird wie folgt aussehen:

{
    "customers": [
        {
            "info": {
                "id": 1,
                "username": "pippin",
                "display_name": "Pippin Williamson",
                "first_name": "Pippin",
                "last_name": "Williamson",
                "email": "[email protected]"
            },
            "stats": {
                "total_purchases": 61,
                "total_spent": 1139.68,
                "total_downloads": 31
            }
        }
    ]
}