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": "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.