# Recensioni - REST API [Recensioni](https://easydigitaldownloads.com/downloads/product-reviews/?utm_campaign=documentation&utm_source=helpscout&utm_medium=doc&utm_term=1397-product-reviews-rest-api) si integra con l'[EDD REST API](https://easydigitaldownloads.com/docs/edd-rest-api-introduction/) consentendo di recuperare le recensioni in formato JSON o XML. L'[EDD REST API](https://easydigitaldownloads.com/docs/edd-rest-api-introduction/) fornisce un endpoint chiamato `/reviews/`. L'endpoint delle recensioni 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 è la seguente: ``` 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** - Il 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 sospeso). 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 è la seguente: ``` { "reviews": { "total": "2", "most_recent": [ { "id": "63", "title": null, "parent": "60", "download_id": "1568", "download_title": "Endless Possibilities", "rating": null, "author": "Sunny Ratilal", "email": "dev@local.dev", "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": "dev@local.dev", "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 si desidera ricevere i dati per una singola recensione, è possibile aggiungere il parametro *&review\_id={identifier}*, come segue: ``` https://yoursite.com/edd-api/reviews/?key=c281cf0a95be875d9eeb284fb004c938&token=5f9432f3ffa5945755ebc66179810d70&review_id=61 ``` La risposta per una singola recensione è la seguente: ``` { "reviews": { "id": "61", "title": "Great read", "parent": "0", "download_id": "1566", "download_title": "eBook", "rating": "4", "author": "Sunny Ratilal", "email": "dev@local.dev", "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 si desidera visualizzare tutte le recensioni per un singolo download, è possibile aggiungere il parametro *&download\_id={identifier}*, come segue: ``` 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`