# EDD REST API - Endpoint L'[EDD REST API](<L'EDD REST API (collegala alla panoramica) include X endpoint per accedere alle informazioni>) include sei endpoint per accedere alle informazioni, ognuno per eseguire un tipo specifico di richiesta: - **stats** - Per recuperare le statistiche di guadagno/vendita per date specifiche, intervalli di date e prodotti specifici. - **products** - Per recuperare informazioni sui prodotti del negozio. - **customers** - Per recuperare le statistiche dei clienti. - **sales** - Per recuperare le vendite recenti e informazioni su ciascuna vendita (articoli acquistati, acquirente, importo, ecc.). - **discounts** - Per recuperare informazioni su tutti gli sconti disponibili. - **download-logs** - Per recuperare i log dei download di file. Gli endpoint vengono utilizzati in questo modo: ``` https://example.com/edd-api// ``` Ad esempio: ``` https://example.com/edd-api/sales/ ``` Se combinato con la chiave API e il token, l'URL completo appare così: ``` https://example.com/edd-api/sales/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70 ``` ### Visibilità Tutti gli endpoint richiedono la chiave API e il token, ad eccezione dell'endpoint products. Questo perché i prodotti sono destinati ad essere pubblici in ogni momento per impostazione predefinita. ### Formato della risposta La risposta fornita dall'API EDD è disponibile in due formati: - [JSON](https://en.wikipedia.org/wiki/JSON) (predefinito) - [XML](https://en.wikipedia.org/wiki/XML) Per specificare il formato restituito (verrà utilizzato jSON se non ne viene specificato nessuno), è sufficiente aggiungere l'argomento *format* all'URL: ``` https://yoursite.com/edd-api/sales/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&format=xml ``` Una risposta JSON di esempio appare così: ``` { "sales": [ { "ID": 611, "subtotal": "20", "tax": 0, "fees": false, "total": "20", "gateway": "manual", "email": "johntest23@test.com", "date": "2013-02-25 11:42:05", "products": [ { "name": "Simple Notices Pro", "price": "20", "price_name": "Price one" } ] } ] } ``` Una risposta XML di esempio (per la stessa query) appare così: ``` 611 20 0 false 20 manual johntest23@test.com 2013-02-25 11:42:05 Simple Notices Pro 20 Price one ``` ### Variabili URL opzionali Puoi aggiungere variabili URL aggiuntive per regolare l'output fornito. Ecco alcuni esempi di come puoi farlo. - **Number**: Per impostazione predefinita, l'API mostrerà 10 risultati per pagina, se questo è ciò che hai impostato nelle tue impostazioni di lettura in WordPress. Ma se vuoi cambiarlo per una specifica chiamata API, puoi aggiungere "&number=11" all'URL per ottenere un numero diverso di risultati per pagina. In questo esempio, otterresti 11 risultati. - **Page**: Per impostazione predefinita, l'API mostrerà la pagina 1 dei risultati. Se vuoi cambiarlo per una specifica chiamata API, puoi aggiungere "&page=2" all'URL per ottenere una pagina diversa di risultati.