--- title: "Claves API de Señalización Digital | EasySignage" description: "Crea y gestiona claves API de EasySignage. Otorga acceso por área, autentica solicitudes y revoca una clave en el momento en que ya no la necesites." url: https://easysignage.com/help/es/account-settings/digital-signage-api-keys/ --- # 10- Claves API Una clave API permite que tus propios sistemas lean y actualicen tu señalización a través de la API de EasySignage. Una clave actúa sobre una cuenta con exactamente el acceso que le otorgues, y puedes eliminarla en cualquier momento. ## Antes de empezar - Tu cuenta necesita acceso a la API, incluido en el plan Premium. - Inicia sesión en la cuenta sobre la que actuará la clave. Una clave queda vinculada a la cuenta que estés gestionando en el momento de crearla. ## Crear una clave API 1. Ve a **Settings** > **API Keys** (Configuración > Claves API). 2. Selecciona **Create API Key** (Crear Clave API). 3. Ingresa un **Name** (Nombre) que indique para qué es la clave, por ejemplo el sistema que la usará. 4. Configura cada área de tu cuenta como **No access** (Sin acceso), **Read only** (Solo lectura) o **Full access** (Acceso completo). 5. Selecciona **Create API Key** (Crear Clave API). 6. Copia la clave. > **Advertencia:** La clave se muestra una sola vez y no se puede recuperar después. Cópiala antes de cerrar el cuadro de diálogo. Si la pierdes, elimina la clave y crea una nueva. ## Elegir a qué puede acceder una clave Cada clave tiene sus propios permisos, configurados área por área: - **Screens** (Pantallas) - **Groups** (Grupos) - **Video Wall** - **Playlists** (Listas de reproducción) - **Channels** (Canales) - **Zones** (Zonas) - **Sync groups** (Grupos de sincronización) - **Schedules** (Horarios) - **Folders** (Carpetas) - **Media Assets** (Contenido multimedia) Cada área se configura en uno de tres niveles: | Nivel | Qué puede hacer la clave | | --- | --- | | No access (Sin acceso) | Nada en esa área | | Read only (Solo lectura) | Leer el área, sin hacer cambios | | Full access (Acceso completo) | Leer el área y hacer cambios | Otorga al menos un área. **Create API Key** (Crear Clave API) permanece deshabilitado mientras todas las áreas estén configuradas como **No access** (Sin acceso). Otorga a una clave solo las áreas que el sistema que la usa realmente necesita. ## Autenticar una solicitud Envía la clave en un encabezado `X-API-Key`: ``` X-API-Key: ds_api_... ``` La clave resuelve tanto la marca como la cuenta por sí sola, así que los encabezados `X-Account` y `X-Domain` se ignoran en una solicitud con clave API. Una clave no se puede redirigir a una cuenta distinta. ## Abrir la documentación de la API 1. Ve a **Settings** > **API Keys** (Configuración > Claves API). 2. Selecciona **Open API Docs** (Abrir Documentación de la API). La documentación se abre en una nueva pestaña e inicia sesión automáticamente. No tiene un inicio de sesión aparte, así que ábrela desde **Settings** > **API Keys** en lugar de guardarla como marcador. ## Revisar una clave existente 1. Ve a **Settings** > **API Keys** (Configuración > Claves API). 2. Selecciona el icono de vista en la clave. Cada clave de la lista muestra una versión enmascarada de la credencial, las áreas a las que puede acceder, cuándo se creó y cuándo se usó por última vez. El cuadro de diálogo de detalles también muestra quién la creó. La clave completa no vuelve a mostrarse después de crearse. ## Reemplazar una clave No existe una acción de rotación. Para reemplazar una clave, crea primero la nueva clave, traslada tus sistemas a ella y luego elimina la anterior. Crear el reemplazo primero significa que nada deja de funcionar mientras haces la transición. ## Eliminar una clave 1. Ve a **Settings** > **API Keys** (Configuración > Claves API). 2. Selecciona el icono de eliminar en la clave. 3. Confirma la eliminación. > **Advertencia:** Eliminar una clave surte efecto de inmediato y no se puede deshacer. Cualquier cosa que use esa clave deja de funcionar en su próxima solicitud. Los detalles de la clave se conservan en el registro de tu cuenta. ## Límites - Una cuenta puede tener hasta 10 claves API. - El nombre de una clave puede tener hasta 100 caracteres. - Se debe otorgar al menos un área antes de poder crear una clave. ## Solucionar problemas con las claves API - **El acceso a la API solo está disponible en los planes Premium y Enterprise.** La cuenta no tiene acceso a la API. Consulta tu plan en la [página de precios](https://easysignage.com/digital-signage-software-pricing/) o contacta con soporte. - **Has alcanzado el número máximo de claves API.** La cuenta ya tiene 10 claves. Elimina una que ya no uses y luego crea la nueva clave. - **La clave se creó pero no se pudo mostrar. Elimínala y crea una nueva.** La clave existe pero nunca se mostró, así que no se puede usar. Elimínala y crea un reemplazo. - **No se pudieron abrir los documentos de la API. Inténtalo de nuevo.** No se pudo crear el enlace de inicio de sesión para la documentación. Inténtalo de nuevo y recarga el panel de control si sigue fallando. - **Una solicitud devuelve 403** Una solicitud con clave API que falla en cualquier verificación responde `403` con el cuerpo vacío. Una clave desconocida, una clave alterada, una clave eliminada, un permiso que no se otorgó a la clave y una cuenta sin acceso a la API se ven todos igual, a propósito, para que la API no se pueda usar para descubrir qué claves existen. Verifica que la clave siga apareciendo en **Settings** > **API Keys**, que el área que estás llamando esté otorgada y que la cuenta siga teniendo acceso a la API. ## Artículos relacionados - [Configuración del Asistente de IA](https://easysignage.com/help/account-settings/digital-signage-ai-assistant/) - [Conectar un Asistente de IA (MCP)](https://easysignage.com/help/integrations/ai-assistant-mcp/) - [Registros de la cuenta](https://easysignage.com/help/account-settings/digital-signage-logs/) - [Configuración de seguridad](https://easysignage.com/help/account-settings/digital-signage-security/) [Anterior ##### 9- Fuentes de Datos (API JSON)](https://easysignage.com/help/es/account-settings/digital-signage-data-sources/) [Siguiente ##### 11- Configuración de Canva](https://easysignage.com/help/es/account-settings/digital-signage-canva-settings/)