Recenzii – REST API

Recenzii se integrează cu API-ul REST EDD permițându-vă să preluați recenziile fie în format JSON, fie XML.

API-ul REST EDD oferă un punct final numit /reviews/. Punctul final pentru recenzii vă permite să interogați baza de date și să preluați o listă de recenzii plasate pe toate produsele din magazinul dvs. O interogare de bază pentru recenzii arată astfel:

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

Pentru fiecare recenzie returnată, veți primi următoarele informații:

• id – ID-ul unic al recenziei
• title – Titlul recenziei
• parent – Dacă recenzia este un răspuns, acesta oferă ID-ul recenziei părinte
• download_id – ID-ul produsului pentru care a fost creată această recenzie
• download_title – Titlul produsului pentru care a fost creată această recenzie
• rating – Evaluarea acordată de recenzent. Va fi null pentru un răspuns.
• author – Numele autorului recenziei
• email – Adresa de e-mail a autorului recenziei
• IP – Adresa IP de la care a fost trimisă recenzia
• date – Data la care a fost trimisă recenzia
• date_gmt – Data (în GMT) la care a fost trimisă recenzia
• content – Conținutul recenziei
• status – Starea recenziei. 1 reprezintă aprobat și 0 reprezintă neaprobat (în așteptare). Starea poate fi, de asemenea, „spam” sau „trash”
• user_id – ID-ul utilizatorului WordPress al autorului recenziei
• type – Fie recenzie, fie răspuns, în funcție de ce este
• votes – Numărul de persoane care au votat că această recenzie este utilă sau neutilă. Va fi null pentru un răspuns. Dacă este o recenzie, va avea sub-chei de yes și no

Un răspuns la o interogare de recenzii arată astfel:

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

Anumite variabile de interogare pot fi atașate interogării de bază. Dacă doriți să primiți datele pentru o singură recenzie, puteți adăuga parametrul &review_id={identifier}, astfel:

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

Răspunsul pentru o singură recenzie arată astfel:

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

Dacă doriți să vizualizați toate recenziile pentru un singur produs, puteți adăuga parametrul &download_id={identifier}, astfel:

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

Interogarea de mai sus va genera un răspuns similar cu cel de mai sus, dar va avea mai multe sub-chei sub cheia reviews