Recensioni – REST API

Recensioni si integra con la EDD REST API consentendoti di recuperare le recensioni in formato JSON o XML.

La EDD REST API fornisce un endpoint chiamato /reviews/. L'endpoint delle recensioni ti consente di interrogare il database e recuperare un elenco di recensioni inserite su tutti i prodotti del tuo negozio. Una query di base per le recensioni appare così:

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

Per ogni recensione restituita, riceverai le seguenti informazioni:

• id – L'ID univoco della recensione
• title – Il titolo della recensione
• parent – Se la recensione è una risposta, questo fornisce l'ID della recensione genitore
• download_id – L'ID del download per cui è stata creata questa recensione
• download_title – Titolo del download per cui è stata creata questa recensione
• rating – La valutazione data dal recensore. Sarà null per una risposta.
• author – Il nome dell'autore della recensione
• email – L'indirizzo email dell'autore della recensione
• IP – L'indirizzo IP da cui è stata inviata la recensione
• date – La data in cui è stata inviata la recensione
• date_gmt – La data (in GMT) in cui è stata inviata la recensione
• content – Il contenuto della recensione
• status – Lo stato della recensione. 1 rappresenta approvato e 0 rappresenta non approvato (in attesa). Lo stato può anche essere "spam" o "trash"
• user_id – L'ID utente di WordPress dell'autore della recensione
• type – Una recensione o una risposta a seconda di cosa si tratta
• votes – Il numero di persone che hanno votato che questa recensione è utile o non utile. Sarà null per una risposta. Se si tratta di una recensione, avrà sotto-chiavi di yes e no

Una risposta a una query di recensioni appare così:

{
    "reviews": {
        "total": "2",
        "most_recent": [
            {
                "id": "63",
                "title": null,
                "parent": "60",
                "download_id": "1568",
                "download_title": "Endless Possibilities",
                "rating": null,
                "author": "Sunny Ratilal",
                "email": "[email protected]",
                "IP": "172.17.0.1",
                "date": "2016-07-20 17:24:48",
                "date_gmt": "2016-07-20 17:24:48",
                "content": "Replying to test review",
                "status": "1",
                "user_id": "1",
                "type": "reply",
                "votes": null
            },
            {
                "id": "61",
                "title": "Great read",
                "parent": "0",
                "download_id": "1566",
                "download_title": "eBook",
                "rating": "4",
                "author": "Sunny Ratilal",
                "email": "[email protected]",
                "IP": "172.17.0.1",
                "date": "2016-07-19 19:25:22",
                "date_gmt": "2016-07-19 19:25:22",
                "content": "Well written book",
                "status": "1",
                "user_id": "1",
                "type": "review",
                "votes": {
                    "yes": "3",
                    "no": "0"
                }
            },
        ]
    },
    "request_speed": 0.08372688293457
}

È possibile allegare determinate variabili di query alla query di base. Se desideri ricevere i dati per una singola recensione, puoi aggiungere il parametro &review_id={identifier}, così:

https://yoursite.com/edd-api/reviews/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&review_id=61

La risposta per una singola recensione appare così:

{
    "reviews": {
        "id": "61",
        "title": "Great read",
        "parent": "0",
        "download_id": "1566",
        "download_title": "eBook",
        "rating": "4",
        "author": "Sunny Ratilal",
        "email": "[email protected]",
        "IP": "172.17.0.1",
        "date": "2016-07-19 19:25:22",
        "date_gmt": "2016-07-19 19:25:22",
        "content": "Well written book",
        "status": "1",
        "user_id": "1"
    },
    "request_speed": 0.0022079944610596
}

Se desideri visualizzare tutte le recensioni per un singolo download, puoi aggiungere il parametro &download_id={identifier}, così:

https://yoursite.com/edd-api/reviews/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&download_id=1568

La query sopra genererà una risposta simile a quella sopra, ma avrà più sotto-chiavi sotto la chiave reviews