EDD REST API – Estadísticas

La
API REST de EDD puede devolver una gran cantidad de información estadística sobre tu tienda utilizando el endpoint /stats/. La consulta de estadísticas se utiliza para recuperar estadísticas de ganancias/ventas de tu tienda. Se puede usar para recuperar las ganancias totales del mes actual, del año pasado, de un rango de fechas específico, etc., así como las mismas opciones para las ventas. También se puede usar para recuperar estadísticas de ganancias/ventas para cualquier producto o para todos.

El endpoint de estadísticas es:

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

Ten en cuenta que la consulta de
estadísticas requiere que se pase un parámetro type. Hay dos opciones de tipo:

• sales – Para recuperar estadísticas de ventas.
• earnings – Para recuperar estadísticas de ganancias.

Ambos tipos de consulta de
ventas y ganancias incluyen parámetros adicionales para opciones de fecha y producto:

• date – The date to retrieve earnings or sales for. This has three accepted values:
  • today – Recuperará estadísticas del día actual.
  • yesterday – Recuperará estadísticas del día anterior.
  • range – Will retrieve stats for a date range.
    • startdate – Formato: YYYYMMDD. Ejemplo: 20120224 = 24/02/2012
    • enddate – Formato: YYYYMMDD. Ejemplo: 20120531 = 31/05/2012
• product – used to retrieve sale or earnings stats for a specific product, or all products. This option has two accepted values:
  • # – El ID del producto para el que se recuperarán las estadísticas.
  • all – Recuperar estadísticas para todos los productos. Esta opción no admite paginación.

Nota: las opciones de producto y fecha no se pueden combinar. Solo puedes usar una u otra.

Una consulta básica de estadísticas de ganancias se ve así:

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

Y la respuesta es:

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

Una consulta básica de estadísticas de ventas se ve así:

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

Y la respuesta es:

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

Si se pasa una fecha de
hoy o ayer, la consulta se ve así:

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

Y la respuesta:

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

Si se pasa un rango de fechas, la consulta será:

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

Y la respuesta:

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

Cada elemento en el objeto
ventas representa el día y el valor es la cantidad.

Si se pasa el parámetro
producto, de esta manera

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

la respuesta será:

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

O para un producto individual:

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

Respuesta:

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