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!
Ważne
Przechowuj swój klucz API bezpiecznie. Zostanie on wyświetlony tylko raz podczas tworzenia. Jeśli go zgubisz, będziesz musiał utworzyć nowy.
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..."Tip
You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.
Krok 3: Obsłuż odpowiedź
API zwraca odpowiedzi w formacie JSON. Oto przykładowa odpowiedź z punktu końcowego urządzeń:
Responsejson
{
"content": [
{
"pathName": "enterprises/acme/assets/asset_123abc",
"identification": "Warehouse-Scanner-01",
"status": "ACTIVE",
"syncedAt": "2026-01-20T14:22:00Z",
"customData": {
"metadata": { "department": "Warehouse", "location": "Building A" },
"tags": ["scanner", "warehouse"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123456",
"model": "TC52",
"brand": "Zebra",
"os": "Android",
"osVersion": "13"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_123abc",
"name": "devices/device_123abc",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse",
"enrollmentTime": "2026-01-15T10:30: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.
| Header | 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 |