Bewertungen – REST API

Bewertungen integriert sich mit der EDD REST API und ermöglicht es Ihnen, Bewertungen im JSON- oder XML-Format abzurufen.

Die EDD REST API bietet einen Endpunkt namens /reviews/. Der Bewertungen-Endpunkt ermöglicht es Ihnen, die Datenbank abzufragen und eine Liste von Bewertungen abzurufen, die für alle Produkte in Ihrem Shop abgegeben wurden. Eine grundlegende Abfrage von Bewertungen sieht wie folgt aus:

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

Für jede zurückgegebene Bewertung erhalten Sie die folgenden Informationen:

• id – Die eindeutige ID der Bewertung
• title – Der Titel der Bewertung
• parent – Wenn die Bewertung eine Antwort ist, gibt dies die ID der übergeordneten Bewertung an
• download_id – Die ID des Downloads, für den diese Bewertung erstellt wurde
• download_title – Titel des Downloads, für den diese Bewertung erstellt wurde
• rating – Die vom Bewerter vergebene Bewertung. Dies ist null für eine Antwort.
• author – Der Name des Autors der Bewertung
• email – Die E-Mail-Adresse des Autors der Bewertung
• IP – Die IP-Adresse, von der die Bewertung übermittelt wurde
• date – Das Datum, an dem die Bewertung übermittelt wurde
• date_gmt – Das Datum (in GMT), an dem die Bewertung übermittelt wurde
• content – Der Inhalt der Bewertung
• status – Der Status der Bewertung. 1 steht für genehmigt und 0 für nicht genehmigt (ausstehend). Der Status kann auch „spam“ oder „trash“ sein.
• user_id – Die WordPress-Benutzer-ID des Autors der Bewertung
• type – Entweder eine Bewertung oder eine Antwort, je nachdem, was es ist
• votes – Die Anzahl der Personen, die dafür gestimmt haben, dass diese Bewertung hilfreich oder nicht hilfreich ist. Dies ist null für eine Antwort. Wenn es sich um eine Bewertung handelt, hat sie die Unter-Schlüssel yes und no.

Eine Antwort auf eine Abfrage von Bewertungen sieht wie folgt aus:

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

Bestimmte Abfragevariablen können an die Basisabfrage angehängt werden. Wenn Sie die Daten für eine einzelne Bewertung erhalten möchten, können Sie den Parameter &review_id={identifier} hinzufügen, wie hier:

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

Die Antwort für eine einzelne Bewertung sieht wie folgt aus:

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

Wenn Sie alle Bewertungen für einen einzelnen Download anzeigen möchten, können Sie den Parameter &download_id={identifier} hinzufügen, wie hier:

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

Die obige Abfrage generiert eine ähnliche Antwort wie oben, hat aber mehrere Unter-Schlüssel unter dem Schlüssel reviews.