EDD REST API – Klienci

EDD REST API
EDD REST API udostępnia punkt końcowy o nazwie /customers/. Punkt końcowy klientów pozwala na przeszukiwanie bazy danych i pobieranie listy klientów, którzy kupili produkty w Twoim sklepie. Podstawowe zapytanie o klientów wygląda następująco:

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

Dla każdego zwróconego klienta dostępne są następujące informacje:

• id – Identyfikator użytkownika WordPress. Jeśli klient dokonał zakupu jako gość, zwróci -1.
• username – Nazwa logowania użytkownika WordPress. Jeśli klient kupił jako gość, ta wartość będzie pusta.
• display_name – Nazwa wyświetlana użytkownika WordPress. Jeśli klient kupił jako gość, ta wartość będzie pusta.
• first_name – Imię klienta.
• last_name – Nazwisko klienta.
• email – Adres e-mail klienta.
• total_purchases – Całkowita liczba zakupów dokonanych przez klienta.
• total_spent – Całkowita kwota wydana przez klienta.
• total_downloads – Całkowita liczba pobranych plików przez klienta.

Wraz z danymi zwracanymi dla każdego klienta znajduje się obiekt
stats, który pokazuje całkowitą liczbę klientów w bazie danych.

Odpowiedź na zapytanie o klientów wygląda następująco:

{
    "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
            }
        }
    ]
}

Jeśli chcesz pobrać informacje o konkretnym kliencie, możesz dodać
parametr &customer={identifier}, na przykład:

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

lub

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

Odpowiedź dla pojedynczego klienta będzie wyglądać następująco:

{
    "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
            }
        }
    ]
}