GET /version
Endpunkt: GET /v1/pdapi/version
Auth: Bearer-Token
Berechtigung: REST.Version.Read
Zweck
Nutze diesen Endpunkt als Health-Check und Versionsprüfung für Tools, Dashboards und Skripte.
Pfadparameter
Keine.
Query-Parameter
Keine.
Request-Body
Kein Request-Body.
Antwortschema
200 response schema
| Field | Type | Description |
|---|---|---|
Version |
object | PalDefender version details. |
Version object schema:
| Field | Type | Description |
|---|---|---|
Major |
integer | Major version number. |
Minor |
integer | Minor version number. |
Patch |
integer | Patch version number. |
Build |
integer | Build number. |
Version |
string | Short version string. |
VersionLong |
string | Long version string. |
Beta |
boolean | Whether this build is marked as beta. |
Fehlerantworten
Fehlerantworten verwenden dieses Format:
| HTTP | Fehlercode | Wann es passiert |
|---|---|---|
401 |
INVALID_TOKEN |
Der Authorization-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token. |
403 |
MISSING_PERMISSION |
Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt. |
Beispiele
Health and version check
Szenarien
- Nutze ihn nach dem Konfigurieren des REST-API-Tokens, um die Authentifizierung zu prüfen.
- Nutze ihn vor weiteren Endpunktaufrufen, wenn dein Tool eine Mindestversion von PalDefender benötigt.
- Nutze ihn für Monitoring, da es der kleinste schreibgeschützte Request ist.