Démarrage
Mettez-vous en marche avec l'API Nomid MDM en quelques minutes seulement. Ce guide vous guidera dans la configuration de l'authentification et la réalisation de votre premier appel API.
Prérequis
- Un compte Nomid MDM avec accès administrateur
- Accès aux Paramètres de l'entreprise dans le portail
- Un outil pour effectuer des requêtes HTTP (curl, Postman, ou votre langage préféré)
Étape 1 : Créer une clé API
- Connectez-vous au portail Nomid sur portal.nomid.tech
- Naviguez vers Paramètres de l'entreprise > Intégrations
- Cliquez sur 'Créer une clé API' et donnez-lui un nom descriptif
- Copiez la clé API – elle ne sera affichée qu'une seule fois !
Important
Stockez votre clé API en toute sécurité. Elle ne sera affichée qu'une seule fois lors de sa création. Si vous la perdez, vous devrez en créer une nouvelle.
Étape 2 : Faites votre première requête
Utilisez votre clé API pour authentifier les requêtes. Incluez-la dans l'en-tête 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.
Étape 3 : Gérez la réponse
L'API renvoie des réponses JSON. Voici un exemple de réponse de l'endpoint des appareils :
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
}Les réponses sont paginées. Utilisez les paramètres de requête 'page' et 'size' pour naviguer dans les résultats.
Limites de taux
L'API inclut des en-têtes de limite de taux dans chaque réponse. Surveillez-les pour éviter d'atteindre les limites.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Requêtes maximales autorisées par minute |
| X-RateLimit-Remaining | Requêtes restantes dans la fenêtre actuelle |
| X-RateLimit-Reset | Horodatage Unix de réinitialisation de la limite de taux |