EDD REST API – Clientes

La
API REST de EDD proporciona un punto final llamado /customers/. El punto final de clientes le permite consultar la base de datos y recuperar una lista de clientes que han comprado artículos en su tienda. Una consulta básica de clientes se ve así:

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

Por cada cliente devuelto, se devuelve la siguiente información para cada cliente:

• id – El ID de usuario de WordPress. Si el cliente compró como invitado, esto devolverá -1.
• username – El nombre de inicio de sesión del usuario de WordPress. Si el cliente compró como invitado, esto no devolverá nada.
• display_name – El nombre para mostrar del usuario de WordPress. Si el cliente compró como invitado, esto no devolverá nada.
• first_name – El nombre del cliente.
• last_name – El apellido del cliente.
• email – La dirección de correo electrónico del cliente.
• total_purchases – El número total de compras que ha realizado el cliente.
• total_spent – El importe total que ha gastado el cliente.
• total_downloads – El número total de archivos que ha descargado el cliente.

Junto con los datos devueltos para cada cliente hay un objeto
stats que muestra el número total de clientes en la base de datos.

Una respuesta de consulta de clientes se ve así:

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

Si desea recuperar la información de un cliente específico, puede agregar el
parámetro &customer={identifier}, así:

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

o

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

La respuesta para un solo cliente será así:

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