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 !
É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..."É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 :
{
"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
}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.
| HTTP | 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 |