Erste Schritte
Starten Sie in wenigen Minuten mit der Nomid MDM API. Diese Anleitung führt Sie durch die Einrichtung der Authentifizierung und Ihren ersten API-Aufruf.
Voraussetzungen
- Ein Nomid MDM-Konto mit Administratorzugriff
- Zugriff auf die Firmeneinstellungen im Portal
- Ein Tool zum Senden von HTTP-Anfragen (curl, Postman oder Ihre bevorzugte Sprache)
Schritt 1: Erstellen Sie einen API-Schlüssel
- Melden Sie sich im Nomid Portal unter portal.nomid.tech an
- Navigieren Sie zu Firmeneinstellungen > Integrationen
- Klicken Sie auf 'API-Schlüssel erstellen' und geben Sie ihm einen beschreibenden Namen
- Kopieren Sie den API-Schlüssel - er wird nur einmal angezeigt!
Wichtig
Bewahren Sie Ihren API-Schlüssel sicher auf. Er wird nur einmal bei der Erstellung angezeigt. Wenn Sie ihn verlieren, müssen Sie einen neuen erstellen.
Schritt 2: Ihre erste Anfrage stellen
Verwenden Sie Ihren API-Schlüssel zur Authentifizierung von Anfragen. Fügen Sie ihn im X-API-Key-Header ein:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_abc123..."Tip
You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.
Schritt 3: Die Antwort verarbeiten
Die API gibt JSON-Antworten zurück. Hier ist eine Beispielantwort vom Endpunkt 'devices':
Responsejson
{
"content": [
{
"pathName": "enterprises/acme/assets/asset_123abc",
"identification": "Warehouse-Scanner-01",
"status": "ACTIVE",
"syncedAt": "2026-01-20T14:22:00Z",
"customData": {
"metadata": { "department": "Warehouse", "location": "Building A" },
"tags": ["scanner", "warehouse"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123456",
"model": "TC52",
"brand": "Zebra",
"os": "Android",
"osVersion": "13"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_123abc",
"name": "devices/device_123abc",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse",
"enrollmentTime": "2026-01-15T10:30:00Z"
}
}
],
"totalElements": 1,
"totalPages": 1,
"size": 20,
"number": 0
}Antworten sind paginiert. Verwenden Sie die Query-Parameter 'page' und 'size', um durch die Ergebnisse zu navigieren.
Ratenbegrenzungen
Die API fügt in jeder Antwort Ratenbegrenzungs-Header hinzu. Überwachen Sie diese, um die Limits nicht zu überschreiten.
| Header | Beschreibung |
|---|---|
| X-RateLimit-Limit | Maximale Anzahl von Anfragen pro Minute |
| X-RateLimit-Remaining | Verbleibende Anfragen im aktuellen Zeitfenster |
| X-RateLimit-Reset | Unix-Zeitstempel, wann das Ratenlimit zurückgesetzt wird |