Pierwsze kroki

Rozpocznij pracę z Nomid MDM API w zaledwie kilka minut. Ten przewodnik przeprowadzi Cię przez konfigurację uwierzytelniania i wykonanie pierwszego wywołania API.

Wymagania wstępne

Konto Nomid MDM z dostępem administratora
Dostęp do Ustawień Firmy w Portalu
Narzędzie do wykonywania żądań HTTP (curl, Postman lub preferowany język)

Krok 1: Utwórz klucz API

Zaloguj się do Portalu Nomid pod adresem portal.nomid.tech
Przejdź do Ustawienia Firmy > Integracje
Kliknij „Utwórz klucz API” i nadaj mu opisową nazwę
Skopiuj klucz API – zostanie on wyświetlony tylko raz!

Krok 2: Złóż pierwsze żądanie

Użyj swojego klucza API do uwierzytelniania żądań. Dołącz go w nagłówku X-API-Key:

curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
  -H "X-API-Key: nm_acme_abc123..."

Krok 3: Obsłuż odpowiedź

API zwraca odpowiedzi w formacie JSON. Oto przykładowa odpowiedź z punktu końcowego urządzeń:

{
  "content": [{
    "pathName": "k3x9m2pa",
    "identification": "Warehouse-Scanner-01",
    "status": "ACTIVE",
    "syncedAt": "2026-01-20T14:22:00Z"
  }],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Odpowiedzi są stronicowane. Użyj parametrów zapytania 'page' i 'size' do nawigacji po wynikach.

Limity szybkości (Rate limits)

Punkty końcowe REST do odczytu nie stosują limitu na klucz w aplikacji Nomid, ale należy zaprogramować klienta tak, aby wstrzymywał operacje przy błędzie 429. Punkt końcowy MCP zezwala na 60 żądań na minutę na klucz. Komendy urządzeń, zmiany zasad (każde wywołanie propose i apply) oraz kody QR do provisioningu współdzielą limit zapisu wynoszący 10 na minutę na klucz, obejmujący punkty końcowe REST i narzędzia MCP. Połączenie Sign in with Nomid posiada takie same limity MCP i zapisu, naliczane na połączenie.

HTTP	Opis
Retry-After	Liczba sekund oczekiwania przed ponowieniem próby. Wysyłana wraz z odpowiedziami HTTP 429 z punktu końcowego MCP, punktów końcowych komend REST, punktów końcowych zmian zasad oraz punktu końcowego kodu QR do provisioningu.

Interfejs API nie wysyła nagłówków X-RateLimit-Limit, X-RateLimit-Remaining ani X-RateLimit-Reset.

Następne kroki

Przeglądaj punkty końcowe zasobów Dowiedz się o politykach Dokumentacja API