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

  1. Melden Sie sich im Nomid Portal unter portal.nomid.tech an
  2. Navigieren Sie zu Firmeneinstellungen > Integrationen
  3. Klicken Sie auf 'API-Schlüssel erstellen' und geben Sie ihm einen beschreibenden Namen
  4. 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.

HTTPBeschreibung
Retry-AfterSekunden, 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.

Nächste Schritte

Wählen Sie Ihre Zeit

Wird geladen...
Buchungskalender öffnen