Démarrage

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

1. Connectez-vous au portail Nomid sur portal.nomid.tech
2. Naviguez vers Paramètres de l'entreprise > Intégrations
3. Cliquez sur 'Créer une clé API' et donnez-lui un nom descriptif
4. 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": "k3x9m2pa",
    "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 débit

Les points de terminaison de lecture REST n'appliquent pas de limite par clé dans l'application Nomid, mais concevez tout de même votre client pour qu'il temporise sur un code 429. Le point de terminaison MCP autorise 60 requêtes par minute et par clé. Les commandes d'appareils, les modifications de stratégie (chaque appel de proposition et d'application) et les codes QR d'approvisionnement partagent une limite d'écriture de 10 par minute et par clé, sur l'ensemble des points de terminaison REST et des outils MCP. Une connexion Sign in with Nomid dispose des mêmes limites MCP et d'écriture, comptabilisées par connexion.

L'API n'envoie pas les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining ou X-RateLimit-Reset.

Prochaines étapes