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": "enterprises/acme/assets/asset_123abc",
"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 API fügt in jeder Antwort Ratenbegrenzungs-Header hinzu. Überwachen Sie diese, um die Limits nicht zu überschreiten.
| HTTP | 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 |