L'API REST di EDD include sei endpoint per accedere alle informazioni, ognuno per eseguire un tipo specifico di richiesta:
- statistiche – Per recuperare statistiche di guadagni/vendite per date specifiche, intervalli di date e prodotti specifici.
- prodotti – Per recuperare informazioni sui prodotti del negozio.
- clienti – Per recuperare statistiche sui clienti.
- vendite – Per recuperare vendite recenti e informazioni su ciascuna vendita (articoli acquistati, acquirente, importo, ecc.).
- sconti – Per recuperare informazioni su tutti gli sconti disponibili.
- log-download – Per recuperare i log dei download dei 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 prodotti. Questo perché i prodotti sono destinati ad essere pubblici in ogni momento per impostazione predefinita.
Formato di Risposta
La risposta fornita dall'API EDD è disponibile in due formati:
Per specificare il formato restituito (verrà utilizzato JSON se non ne viene specificato nessuno), è sufficiente aggiungere l'argomento
formato 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": "[email protected]",
"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
[email protected]
2013-02-25 11:42:05
Simple Notices Pro
20
Price one
Variabili URL Opzionali
È possibile aggiungere variabili URL aggiuntive per regolare l'output fornito. Ecco alcuni esempi di come è possibile farlo.
- Numero: Per impostazione predefinita, l'API mostrerà 10 risultati per pagina, se questo è quanto impostato nelle tue impostazioni di Lettura in WordPress. Ma se vuoi cambiarlo per una specifica chiamata API, puoi aggiungere "&numero=11" all'URL per ottenere un numero diverso di risultati per pagina. In questo esempio, otterresti 11 risultati.
- Pagina: Per impostazione predefinita, l'API mostrerà la pagina numero 1 dei risultati. Se vuoi cambiarlo per una specifica chiamata API, puoi aggiungere "&pagina=2" all'URL per ottenere una pagina diversa di risultati.
