Loading...
Richtlinien-API
Endpunkte für den Zugriff auf Richtlinienmetadaten in Ihrer Organisation.
GET
/policiesRichtlinien auflisten
Gibt eine Liste aller Richtlinien in Ihrer Organisation mit Metadaten zurück.
Request
curl -X GET "https://api.nomid.tech/emm/api/v1/policies" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
[
{
"pathName": "enterprises/acme/policies/warehouse",
"displayName": "Warehouse Policy",
"description": "Policy for warehouse scanner devices",
"version": 3,
"providerVersion": "1.2.0",
"mainGroup": "Operations"
},
{
"pathName": "enterprises/acme/policies/retail",
"displayName": "Retail Store Policy",
"description": "Policy for retail POS devices",
"version": 5,
"providerVersion": "1.2.0",
"mainGroup": "Retail"
},
{
"pathName": "enterprises/acme/policies/field",
"displayName": "Field Workers Policy",
"description": "Policy for field service technicians",
"version": 2,
"providerVersion": "1.1.0",
"mainGroup": "Field Services"
}
]GET
/policies/{policyId}Richtlinie abrufen
Gibt detaillierte Metadaten für eine bestimmte Richtlinie anhand ihres Pfadnamens zurück.
The policy ID contains forward slashes, so it must be URL-encoded. Use encodeURIComponent() in JavaScript or urllib.parse.quote() in Python.
Request
curl -X GET "https://api.nomid.tech/emm/api/v1/policies/enterprises%2Facme%2Fpolicies%2Fwarehouse" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
{
"pathName": "enterprises/acme/policies/warehouse",
"displayName": "Warehouse Policy",
"description": "Policy for warehouse scanner devices",
"version": 3,
"providerVersion": "1.2.0",
"mainGroup": "Operations"
}Sicherheitshinweis
Richtlinienkonfigurationsdetails werden aus Sicherheitsgründen NICHT über die öffentliche API offengelegt. Nur Metadaten über Richtlinien werden zurückgegeben. Die Konfiguration sollte über das Nomid Portal erfolgen.
Antwortfelder
| Field | Type | Description |
|---|---|---|
| pathName | string | Vollständiger Richtlinienpfad in der Hierarchie (z.B. enterprises/acme/policies/warehouse) |
| displayName | string | Menschlich lesbarer Richtlinienname |
| description | string | Beschreibungstext der Richtlinie |
| version | integer | Richtlinienversionsnummer (wird bei jeder Aktualisierung erhöht) |
| providerVersion | string | MDM-Anbieterversion, mit der diese Richtlinie kompatibel ist |
| mainGroup | string | Richtliniengruppenname für organisatorische Kategorisierung |