EDD REST API – Statistici

EDD REST API poate returna o cantitate mare de informații statistice despre magazinul dvs. folosind endpoint-ul /stats/. Interogarea stats este utilizată pentru preluarea statisticilor de câștiguri/vânzări din magazinul dvs. Poate fi utilizată pentru a prelua câștigurile totale pentru luna curentă, anul trecut, o anumită perioadă de date etc., precum și aceleași opțiuni pentru vânzări. Poate fi, de asemenea, utilizată pentru preluarea statisticilor de câștiguri / vânzări pentru oricare sau toate produsele.

Endpoint-ul stats este:

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

Rețineți că interogarea stats necesită un parametru type care să fie transmis. Există două opțiuni de tip:

• sales – Pentru preluarea statisticilor de vânzări.
• earnings – Pentru preluarea statisticilor de câștiguri.

Ambele tipuri de interogări sales și earnings includ parametri suplimentari pentru opțiuni de dată și produs:

• date – Data pentru care se preiau câștigurile sau vânzările. Aceasta are trei valori acceptate:
  • today – Va prelua statisticile pentru ziua curentă.
  • yesterday – Va prelua statisticile pentru ziua precedentă.
  • range – Va prelua statisticile pentru o perioadă de date.
    • startdate – Format: YYYYMMDD. Exemplu: 20120224 = 2012/02/24
    • enddate – Format: YYYYMMDD. Exemplu: 20120531 = 2012/02/24
• product – utilizat pentru preluarea statisticilor de vânzări sau câștiguri pentru un produs specific sau pentru toate produsele. Această opțiune are două valori acceptate:
  • # – ID-ul produsului pentru care se preiau statisticile.
  • all – Preluare statistici pentru toate produsele. Această opțiune nu suportă paginare.

Notă: opțiunile product și date nu pot fi combinate. Puteți utiliza doar una dintre ele.

O interogare de bază pentru statistici de câștiguri arată astfel:

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

Și răspunsul este:

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

O interogare de bază pentru statistici de vânzări arată astfel:

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

Și răspunsul este:

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

Dacă se transmite o dată de today sau yesterday, interogarea arată astfel:

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

Și răspunsul:

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

Dacă se transmite o perioadă de date, interogarea va fi:

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

Și răspunsul:

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

Fiecare element din obiectul sales reprezintă ziua, iar valoarea este suma.

Dacă se transmite parametrul product, astfel

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

răspunsul va fi:

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

Sau pentru un produs individual:

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

Răspuns:

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