# EDD REST API V2 - Clienti Questo documento si riferisce specificamente alla Versione 2 dell'API EDD. [La documentazione per la Versione 1 è qui](https://easydigitaldownloads.com/docs/edd-rest-api-customers/). L'[API REST EDD](https://easydigitaldownloads.com/docs/edd-rest-api-introduction/) fornisce un endpoint chiamato `/customers/`. L'endpoint dei clienti ti consente di interrogare il database e recuperare un elenco di clienti che hanno acquistato articoli dal tuo negozio. Una query di base per i clienti si presenta così: ``` https://tuosito.com/edd-api/v2/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&number=25 ``` Per ogni cliente restituito, vengono fornite le seguenti informazioni per ciascun cliente: - **customer\_id** - L'ID univoco del cliente. Corrisponde a `id` in questo risultato API. - **user\_id** - L'ID utente di WordPress. Se il cliente ha acquistato come ospite, questo valore sarà vuoto. - **username** - Il nome di accesso dell'utente di WordPress. Se il cliente ha acquistato come ospite, questo valore sarà vuoto. - **display\_name** - Il nome visualizzato dell'utente di WordPress. Se il cliente ha acquistato come ospite, questo valore sarà vuoto. - **first\_name** - Il nome del cliente. - **last\_name** - Il cognome del cliente. - **email** - L'indirizzo email del cliente. - **date\_created** - La data in cui questo cliente è stato creato in EDD. - **total\_purchases** - Il numero totale di acquisti effettuati dal cliente. - **total\_spent** - L'importo totale speso dal cliente. - **total\_downloads** - Il numero totale di file scaricati dal cliente. - **date** - La data per recuperare i clienti. Questo ha tre valori accettati: - **today** - Recupererà i clienti creati nel giorno corrente. - **yesterday** - Recupererà i clienti creati il giorno precedente. - **range** - Recupererà i clienti creati all'interno di un intervallo di date. - **startdate** - Formato: YYYYMMDD. Esempio: 20120224 = 2012/02/24 - **enddate** - Formato: YYYYMMDD. Esempio: 20120531 = 2012/02/24 Insieme ai dati restituiti per ogni cliente, c'è un oggetto *stats* che mostra il numero totale di clienti nel database. Una risposta di query per i clienti si presenta così: ``` { "customers": [ { "info": { "id": "3", "user_id": "", "username": "", "display_name": "", "customer_id": "3", "first_name": "Matthew", "last_name": "Dixon", "email": "matthew@example.com", "additional_emails": [], "date_created": "2016-05-28 00:09:40" }, "stats": { "total_purchases": "1", "total_spent": "20.000000", "total_downloads": 0 } }, { "info": { "id": "2", "user_id": "2", "username": "bob", "display_name": "bob", "customer_id": "2", "first_name": "", "last_name": "", "email": "bob@example.com", "additional_emails": [ "robert.joiner@example.com" ], "date_created": "2016-05-17 14:17:15" }, "stats": { "total_purchases": "1", "total_spent": "0.000000", "total_downloads": 0 } }, { "info": { "id": "1", "user_id": "1", "username": "jose", "display_name": "Jose", "customer_id": "1", "first_name": "Jose", "last_name": "Espinoza", "email": "jose@example.com", "additional_emails": [], "date_created": "2016-05-17 14:08:57" }, "stats": { "total_purchases": "6", "total_spent": "70.000000", "total_downloads": 2 } } ], "request_speed": 0.0081720352172852 } ``` Se desideri recuperare le informazioni per un cliente specifico, puoi aggiungere il parametro *&customer={identifier}*, così: ``` https://tuosito.com/edd-api/v2/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&customer=1 ``` o ``` https://tuosito.com/edd-api/v2/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&customer=jose@domain.com ``` La risposta per un singolo cliente sarà simile a questa: ``` { "customers": [ { "info": { "id": "1", "user_id": "1", "username": "jose", "display_name": "Jose", "customer_id": "1", "first_name": "Jose", "last_name": "Espinoza", "email": "jose@example.com", "additional_emails": [], "date_created": "2016-05-17 14:08:57" }, "stats": { "total_purchases": "6", "total_spent": "70.000000", "total_downloads": 2 } } ] } ``` Una query che cerca clienti creati oggi si presenterebbe così: ``` https://tuosito.com/edd-api/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&date=today ``` Un intervallo di date si presenterebbe così: ``` https://tuosito.com/edd-api/customers/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&date=range&startdate=20130201&enddate=20130210 ```