Comenzar

Comienza a usar la API de Nomid MDM en solo unos minutos. Esta guía te llevará a través de la configuración de autenticación y tu primera llamada a la API.

Requisitos Previos

  • Una cuenta de Nomid MDM con acceso de administrador
  • Acceso a la Configuración de la Empresa en el Portal
  • Una herramienta para hacer solicitudes HTTP (curl, Postman, o tu lenguaje preferido)

Paso 1: Crear una Clave API

  1. Inicia sesión en el Portal de Nomid en portal.nomid.tech
  2. Navega a Configuración de la Empresa > Integraciones
  3. Haz clic en 'Crear Clave API' y dale un nombre descriptivo
  4. Copia la clave API - ¡solo se mostrará una vez!

Paso 2: Haz Tu Primera Solicitud

Usa tu clave API para autenticar las solicitudes. Inclúyela en el encabezado X-API-Key:

curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
  -H "X-API-Key: nm_acme_abc123..."

Paso 3: Maneja la Respuesta

La API devuelve respuestas JSON. Aquí hay un ejemplo de respuesta del endpoint de dispositivos:

{
  "content": [{
    "pathName": "k3x9m2pa",
    "identification": "Warehouse-Scanner-01",
    "status": "ACTIVE",
    "syncedAt": "2026-01-20T14:22:00Z"
  }],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Las respuestas están paginadas. Usa los parámetros 'page' y 'size' para navegar por los resultados.

Límites de frecuencia

Los endpoints de lectura REST no aplican un límite por clave en la aplicación Nomid, pero diseñe su cliente para que aplique una espera progresiva (backoff) ante un error 429 de todos modos. El endpoint MCP permite 60 solicitudes por minuto por clave. Los comandos de dispositivos, los cambios de políticas (cada llamada de proponer y aplicar) y los códigos QR de aprovisionamiento comparten un límite de escritura de 10 por minuto por clave, entre los endpoints REST y las herramientas MCP. Una conexión Sign in with Nomid tiene los mismos límites de MCP y de escritura, contabilizados por conexión.

HTTPDescripción
Retry-AfterSegundos de espera antes de reintentar. Se envía con las respuestas HTTP 429 del endpoint MCP, los endpoints de comandos REST, los endpoints de cambios de políticas y el endpoint de códigos QR de aprovisionamiento.

La API no envía los encabezados X-RateLimit-Limit, X-RateLimit-Remaining ni X-RateLimit-Reset.

Próximos Pasos

Elija su horario

Cargando...
Abrir el calendario de reservas