Provenexpert :: PPH API Docs

Ratings

GET public/provenexpert/list

Gets a list of provenexpert ratings

Query-Parameter

Feld	Datentyp	Beschreibung
limit	bool	Results per page. Example: 4
shuffle	bool	Shuffle the results.
min-text-len	int	Limit the rating texts.
all	boolean	Get all requests.
stars	int	Get only ratings with specific or more stars.

curl -X GET \
-G 'https://api.pph.sh/public/provenexpert/list' \
-H 'Content-Type=application/json' \
-H 'Accept=application/json' \
-H 'Accept-Language=de; *;q=0.5' | jq

{
    "data": [
        {
            "id": 1075,
            "hash": "0b1b3b09898bb2d87bb4c88e735c62d0",
            "author": "Joerg D.",
            "recommended": 1,
            "stars": 4,
            "text": "Die Preis-Leistung ist top jedoch ist der Server etwas langsam. Der Support Antwortet schnell aber k\u00f6nnen mir nicht helfen. F\u00fcr Windows m\u00fcssen wir uns selbst um die Lizenz k\u00fcmmern was bei der Anmietung des Servers vorher nicht stand. Ansonsten okay. Wenn diese Probleme behoben werden gerne 5 Sterne",
            "comment": "",
            "date": "2022-02-02"
        }
    ],
    "links": {
        "first": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=1",
        "last": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=506",
        "prev": null,
        "next": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 506,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=5",
                "label": "5",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=6",
                "label": "6",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=7",
                "label": "7",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=8",
                "label": "8",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=9",
                "label": "9",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=10",
                "label": "10",
                "active": false
            },
            {
                "url": null,
                "label": "...",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=505",
                "label": "505",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=506",
                "label": "506",
                "active": false
            },
            {
                "url": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list?min-text-len=5.62&limit=1&page=2",
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https:\/\/fsn-01.api.pph.sh\/public\/provenexpert\/list",
        "per_page": true,
        "to": 1,
        "total": 506
    }
}

General statistics

GET public/provenexpert/stats

Returns general statistics about provenexpert ratings. Totals will be all time accumulations, while "stats"-array can be truncated monthlywise.

Playground

Query-Parameter

Feld	Datentyp	Beschreibung
months	int	Only return stats about last n months. Example: 2

curl -X GET \
-G 'https://api.pph.sh/public/provenexpert/stats' \
-H 'Content-Type=application/json' \
-H 'Accept=application/json' \
-H 'Accept-Language=de; *;q=0.5' | jq

{
    "data": {
        "count": 1056,
        "bad": 134,
        "recommendations": 922,
        "recommendations-factor": 0.87,
        "average-stars": 4.37
    }
}

Summary

GET public/provenexpert/summary

Playground

curl -X GET \
-G 'https://api.pph.sh/public/provenexpert/summary' \
-H 'Content-Type=application/json' \
-H 'Accept=application/json' \
-H 'Accept-Language=de; *;q=0.5' | jq

{
    "data": {
        "status": "success",
        "ratingValue": 4.4,
        "reviewCount": 1331,
        "recommendationRate": 88
    }
}