EDD REST API – Statistiche

La
EDD REST API può restituire una grande quantità di informazioni statistiche sul tuo negozio utilizzando l'endpoint /stats/. La query stats viene utilizzata per recuperare statistiche di guadagni/vendite dal tuo negozio. Può essere utilizzata per recuperare guadagni totali per il mese corrente, l'anno scorso, un intervallo di date specifico, ecc., così come le stesse opzioni per le vendite. Può anche essere utilizzata per recuperare statistiche di guadagni / vendite per uno qualsiasi o tutti i prodotti.

L'endpoint stats è:

https://example.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=

Nota che la
query stats richiede un parametro type. Ci sono due opzioni di tipo:

• sales – Per recuperare statistiche di vendita.
• earnings – Per recuperare statistiche di guadagno.

Entrambi i tipi di query
sales ed earnings includono parametri aggiuntivi per opzioni di data e prodotto:

• date – La data per cui recuperare guadagni o vendite. Questo ha tre valori accettati:
  • today – Recupererà le statistiche per il giorno corrente.
  • yesterday – Recupererà le statistiche per il giorno precedente.
  • range – Recupererà le statistiche per un intervallo di date.
    • startdate – Formato: YYYYMMDD. Esempio: 20120224 = 24/02/2012
    • enddate – Formato: YYYYMMDD. Esempio: 20120531 = 31/05/2012
• product – utilizzato per recuperare statistiche di vendita o guadagno per un prodotto specifico, o tutti i prodotti. Questa opzione ha due valori accettati:
  • # – L'ID del prodotto per cui recuperare le statistiche.
  • all – Recupera statistiche per tutti i prodotti. Questa opzione non supporta il paging.

Nota: le opzioni product e date non possono essere combinate. Puoi usarne solo una o l'altra.

Una query di base per le statistiche di guadagno appare così:

https://example.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=earnings

E la risposta è:

{
    "earnings": {
        "current_month": 20,
        "last_month": 311.96,
        "totals": 1302.2764
    }
}

Una query di base per le statistiche di vendita appare così:

https://yoursite.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=sales

E la risposta è:

{
    "sales": {
        "current_month": 1,
        "last_month": 18,
        "totals": 71
    }
}

Se si passa una data di
today o yesterday, la query appare così:

https://yoursite.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=sales&date=today

E la risposta:

{
    "sales": {
        "today": 1
    }
}

Se si passa un intervallo di date, la query sarà:

https://yoursite.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=sales&date=range&startdate=20130201&enddate=20130210

E la risposta:

{
    "totals": 12,
    "sales": {
        "20130201": 0,
        "20130202": 0,
        "20130203": 0,
        "20130204": 0,
        "20130205": 0,
        "20130206": 1,
        "20130207": 0,
        "20130208": 0,
        "20130209": 11,
        "20130210": 0
    }
}

Ogni elemento nell'oggetto
sales rappresenta il giorno e il valore è l'importo.

Se si passa il parametro
product, in questo modo

https://yoursite.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=sales&product=all

la risposta sarà:

{
    "sales": [
        {
            "test-2": "6"
        },
        {
            "simple-notices-pro": "48"
        },
        {
            "love-it-pro": "13"
        },
        {
            "test-product-2-2": "0"
        },
        {
            "test-product-1-2": "0"
        }
    ]
}

Oppure per un singolo prodotto:

https://yoursite.com/edd-api/stats/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&type=sales&product=16

Risposta:

{
    "sales": [
        {
            "simple-notices-pro": "48"
        }
    ]
}