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!
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..." Schritt 3: Die Antwort verarbeiten
Die API gibt JSON-Antworten zurück. Hier ist eine Beispielantwort vom Endpunkt 'devices':
{
"content": [{
"pathName": "k3x9m2pa",
"identification": "Warehouse-Scanner-01",
"status": "ACTIVE",
"syncedAt": "2026-01-20T14:22: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 REST-Lese-Endpunkte wenden in der Nomid-Anwendung kein Limit pro Schlüssel an, aber erstellen Sie Ihren Client dennoch so, dass er bei 429 zurückweicht. Der MCP-Endpunkt erlaubt 60 Anfragen pro Minute und Schlüssel. Gerätebefehle, Richtlinienänderungen (jeder Aufruf von propose und apply) und Bereitstellungs-QR-Codes teilen sich ein Schreiblimit von 10 pro Minute und Schlüssel über die REST-Endpunkte und die MCP-Tools hinweg. Eine „Sign in with Nomid“-Verbindung hat dieselben MCP- und Schreiblimits, gezählt pro Verbindung.
| HTTP | Beschreibung |
|---|---|
| Retry-After | Sekunden, die vor einem erneuten Versuch gewartet werden muss. Wird mit HTTP 429-Antworten vom MCP-Endpunkt, den REST-Befehlsendpunkten, den Endpunkten für Richtlinienänderungen und dem Endpunkt für Bereitstellungs-QR-Codes gesendet. |
Die API sendet keine X-RateLimit-Limit-, X-RateLimit-Remaining- oder X-RateLimit-Reset-Header.