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": "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
}Odpowiedzi są stronicowane. Użyj parametrów zapytania 'page' i 'size' do nawigacji po wynikach.
Limity żądań
API zawiera nagłówki z limitami żądań w każdej odpowiedzi. Monitoruj je, aby uniknąć przekroczenia limitów.
| HTTP | Opis |
|---|---|
| X-RateLimit-Limit | Maksymalna liczba dozwolonych żądań na minutę |
| X-RateLimit-Remaining | Pozostałe żądania w bieżącym oknie |
| X-RateLimit-Reset | Znacznik czasu Unix, kiedy limit żądań zostanie zresetowany |