EDD REST API – Clienți

The
EDD REST API oferă un endpoint numit /customers/. Endpointul pentru clienți vă permite să interogați baza de date și să preluați o listă de clienți care au achiziționat articole din magazinul dvs. O interogare de bază pentru clienți arată astfel:

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

Pentru fiecare client returnat, următoarele informații sunt returnate pentru fiecare client:

• id – ID-ul utilizatorului WordPress. Dacă clientul a achiziționat ca invitat, acesta va fi returnat ca -1.
• username – Numele de utilizator WordPress. Dacă clientul a achiziționat ca invitat, acesta nu va returna nimic.
• display_name – Numele afișat al utilizatorului WordPress. Dacă clientul a achiziționat ca invitat, acesta nu va returna nimic.
• first_name – Prenumele clientului.
• last_name – Numele de familie al clientului.
• email – Adresa de e-mail a clientului.
• total_purchases – Numărul total de achiziții efectuate de client.
• total_spent – Suma totală cheltuită de client.
• total_downloads – Numărul total de fișiere descărcate de client.

Pe lângă datele returnate pentru fiecare client, există un obiect
stats care arată numărul total de clienți din baza de date.

Un răspuns la o interogare de clienți arată astfel:

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

Dacă doriți să preluați informațiile pentru un client specific, puteți adăuga
parametrul &customer={identifier}, astfel:

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

sau

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

Răspunsul pentru un singur client va fi acesta:

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