Recenzje – REST API

Recenzje integrują się z EDD REST API, umożliwiając pobieranie recenzji w formacie JSON lub XML.

EDD REST API udostępnia punkt końcowy o nazwie /reviews/. Punkt końcowy recenzji pozwala na zapytanie bazy danych i pobranie listy recenzji umieszczonych na wszystkich produktach z Twojego sklepu. Podstawowe zapytanie o recenzje wygląda następująco:

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

Dla każdej zwróconej recenzji otrzymasz następujące informacje:

• id – unikalny identyfikator recenzji
• title – tytuł recenzji
• parent – jeśli recenzja jest odpowiedzią, podaje ID recenzji nadrzędnej
• download_id – ID produktu, dla którego utworzono tę recenzję
• download_title – tytuł produktu, dla którego utworzono tę recenzję
• rating – ocena przyznana przez recenzenta. Będzie to null dla odpowiedzi.
• author – nazwa autora recenzji
• email – adres e-mail autora recenzji
• IP – adres IP, z którego przesłano recenzję
• date – data przesłania recenzji
• date_gmt – data (w GMT) przesłania recenzji
• content – treść recenzji
• status – status recenzji. 1 oznacza zatwierdzoną, a 0 niezatwierdzoną (oczekującą). Status może również oznaczać „spam” lub „trash”
• user_id – ID użytkownika WordPress autora recenzji
• type – recenzja lub odpowiedź, w zależności od tego, czym jest
• votes – liczba osób, które zagłosowały, że ta recenzja jest pomocna lub niepomocna. Będzie to null dla odpowiedzi. Jeśli jest to recenzja, będzie miała podklucze yes i no

Odpowiedź na zapytanie o recenzje wygląda następująco:

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

Do podstawowego zapytania można dołączyć pewne zmienne zapytania. Jeśli chcesz otrzymać dane dla pojedynczej recenzji, możesz dodać parametr &review_id={identifier}, w następujący sposób:

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

Odpowiedź dla pojedynczej recenzji wygląda następująco:

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

Jeśli chcesz wyświetlić wszystkie recenzje dla pojedynczego produktu, możesz dodać parametr &download_id={identifier}, w następujący sposób:

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

Powyższe zapytanie wygeneruje odpowiedź podobną do powyższej, ale będzie zawierać wiele podkluczy pod kluczem reviews