Reseñas – REST API

Reseñas se integra con la API REST de EDD permitiéndole recuperar reseñas en formato JSON o XML.

La API REST de EDD proporciona un punto final llamado /reviews/. El punto final de reseñas le permite consultar la base de datos y recuperar una lista de reseñas publicadas en todos los productos de su tienda. Una consulta básica de reseñas se ve así:

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

Por cada reseña devuelta, recibirá la siguiente información:

• id – El ID único de la reseña
• title – El título de la reseña
• parent – Si la reseña es una respuesta, esto proporciona el ID de la reseña principal
• download_id – El ID de la descarga para la que se creó esta reseña
• download_title – Título de la descarga para la que se creó esta reseña
• rating – La calificación otorgada por el revisor. Será null para una respuesta.
• author – El nombre del autor de la reseña
• email – La dirección de correo electrónico del autor de la reseña
• IP – La dirección IP desde la que se envió la reseña
• date – La fecha en que se envió la reseña
• date_gmt – La fecha (en GMT) en que se envió la reseña
• content – El contenido de la reseña
• status – El estado de la reseña. 1 representa aprobado y 0 representa no aprobado (pendiente). El estado también puede ser “spam” o “trash”
• user_id – El ID de usuario de WordPress del autor de la reseña
• type – Ya sea una reseña o una respuesta, dependiendo de lo que sea
• votes – El número de personas que han votado que esta reseña es útil o no útil. Será null para una respuesta. Si se trata de una reseña, tendrá sub-claves de yes y no

Una respuesta de consulta de reseñas se ve así:

{
    "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
}

Se pueden adjuntar ciertas variables de consulta a la consulta base. Si desea recibir los datos de una sola reseña, puede agregar el parámetro &review_id={identifier}, así:

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

La respuesta para una sola reseña se ve así:

{
    "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
}

Si desea ver todas las reseñas de una sola descarga, puede agregar el parámetro &download_id={identifier}, así:

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

La consulta anterior generará una respuesta similar a la anterior, pero tendrá múltiples sub-claves bajo la clave reviews