--- title: Developer API para Desarrolladores  description: Administre su portal usando las APIs REST de Wordly --- [Ir directamente al contenido](https://help.wordly.ai/es/developer-api#main-content) - [Español](https://help.wordly.ai/es/developer-api) - [English](https://help.wordly.ai/developer-api) - [Français](https://help.wordly.ai/fr/developer-api) Español Traducciones de Mostrar submenú de [![KB Header](https://help.wordly.ai/hs-fs/hubfs/Knowledge%20Base%20Graphics/KB%20Header.png?width=1000&height=150&name=KB%20Header.png)](https://help.wordly.ai/?hsLang=es) Abrir navegación principal Cerrar navegación principal - - [Español](https://help.wordly.ai/es/developer-api) - [English](https://help.wordly.ai/developer-api) - [Français](https://help.wordly.ai/fr/developer-api) Español Traducciones de Mostrar submenú de - [Enviar una solicitud](mailto:support@wordly.ai) [Enviar una solicitud](mailto:support@wordly.ai) Hola! ¿Cómo podemos ayudar? - No hay sugerencias porque el campo de búsqueda está vacío. 1. [Wordly Knowledge Center](https://help.wordly.ai/es?hsLang=es) 2. [Integraciones y API](https://help.wordly.ai/es/integraciones-y-api?hsLang=es) 3. [APIs y Herramientas para Desarrolladores](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#apis-y-herramientas-para-desarrolladores) # Developer API para Desarrolladores ## Administrar su portal usando las APIs REST de Wordly Ahora puede administrar su portal usando las APIs REST de Wordly. Puede ver la documentación de OpenAPI y probar las APIs si mismo en la página [Referencia de la API](https://api.wordly.ai/reference), siempre que tenga [una clave API de desarrollador](https://help.wordly.ai/es/developer-api#eliminar). - Ten en cuenta que la página de Referencia de la API actúa sobre datos en vivo, así que úsala con precaución. - Se añadirán nuevas funcionalidades regularmente, ¡así que mantente atento a más actualizaciones! #### Registro de Cambios (Changelog) [Haga clic aquí](https://help.wordly.ai/api-changelog?hsLang=en) para ver el registro de cambios. ### Obtener de una Clave API de Desarrollador Una clave API de desarrollador debe incluirse como un valor en el encabezado (header) de todas las solicitudes. #### **Requisitos Previos** - Un portal de Wordly con minutos disponibles. - Su portal de Wordly debe ser añadida a una lista de permitidos (allow list) por el [Soporte de Wordly.](mailto:support@wordly.ai) Una vez que su portal haya sido añadida a la lista de permitidos, puede crear una clave API que no caduca en la portada: 1. Ve a su [página de perfil de usuario](https://portal.wordly.ai/#/profile) en el portal de Wordly. 2. Haga clic en el icono de copiar (![copy icon](https://help.wordly.ai/hs-fs/hubfs/Knowledge%20Base%20Graphics/copy%20icon.png?width=39&height=38&name=copy%20icon.png) ) para copiar la clave API en el portapapeles. (Opcional) Haga clic en el icono de actualizar ( ![refresh icon](https://help.wordly.ai/hs-fs/hubfs/Knowledge%20Base%20Graphics/refresh%20icon.png?width=27&height=27&name=refresh%20icon.png)) para crear una nueva clave API. Si no ve la fila "*Clave API* " en su perfil, significa que su portal no ha sido añadida a la lista de permitidos. *No comparta esta clave sin comprender los riesgos de seguridad. Esta clave debe mantenerse en secreto; de lo contrario, un actor malicioso podría suplantarte y acceder a su portal a través de las APIs. Si sospecha que su portal ha sido comprometida,* [elimina su clave API](https://help.wordly.ai/es/developer-api#eliminar) *inmediatamente.* ### Eliminación de una Clave API de Desarrollador Si desea eliminar y revocar su clave API, puede hacerlo a través del portal. #### Para eliminar y revocar su clave API Sigue estos pasos para eliminar su clave API: 1. Ve a su [página de perfil de usuario](https://portal.wordly.ai/#/profile) en el portal de Wordly. 2. Haga clic en el botón de la papelera en la fila **"***Clave API"* para eliminar suclave API. Puede generar una nueva clave API después de eliminar la existente. ### Encabezado de Autorización (Authorization Header) Para poder utilizar la API, debes incluir el encabezado `x-wordly-api-version` con cada solicitud. El valor de este encabezado es su clave API de desarrollador. *Ejemplo:* `x-wordly-api-key: f716690b-4e9a-4656-9523-7003637eb6cc` Si no proporciona la clave API en el encabezado, recibirá una respuesta **401 (No Autorizado)** del servidor. ### Versionado A medida que se lancen nuevas versiones de la API, los esquemas de cuerpo de la solicitud y de la respuesta pueden cambiar. Wordly incluye el encabezado `x-wordly-api-version` en cada respuesta, lo que te indica a qué versión de la API se ajusta el cuerpo de la respuesta. *Ejemplo:* `x-wordly-api-version: 1.0` También puede proporcionar el encabezado `x-wordly-api-version`  en sus solicitudes para fijar el esquema del cuerpo de la solicitud y la respuesta a una versión específica de la API. Esto asegura que sus solicitudes sigan funcionando cuando se lancen nuevas versiones de la API. Si no proporciona el encabezado `x-wordly-api-version` en sus solicitudes, Wordly asumirá la última versión de la API. Por esta razón, recomendamos encarecidamente que incluya este encabezado en cada solicitud. *Si utiliza una versión en el encabezado que ha sido desaprobada, recibirá un error 403 Prohibido. Se avisará con antelación en caso de que una versión de la API sea desaprobada y marcada para su futura eliminación. Encontrará el aviso en el* [registro de cambios de la API](https://help.wordly.ai/api-changelog?hsLang=en)*.* **Esto asume que la versión de la API en cuestión todavía es compatible. Se dará aviso anticipado en caso de que una versión de la API sea desaprobada y marcada para su futura eliminación.** ### Errores`` Si ocurre un error mientras se procesa su solicitud, recibirá una respuesta de error HTTP. En la mayoría de los casos, recibirá un cuerpo de respuesta JSON en el siguiente formato: ``` { "message": "An error message will be here.", "code": 2003, "errors": [ { "message": "Any additional error information..." }, { "message": "...will be listed here." } ]} ``` El campo *código* es un código de error numérico específico de Wordly. La siguiente tabla es una lista de posibles códigos de error que puede recibir en una respuesta de error. | Código de Error | Descripción | | --- | --- | | 2003 | No está autorizado para realizar esta acción. | | 2026 | Un campo no es válido. | | 2041 | La operación no se puede completar porque la sesión está en uso. | | 5001 | Faltan campos obligatorios en la solicitud. | | 5002 | Un campo no es válido. | | 5004 | El recurso solicitado no se pudo encontrar. | ### Cuerpo de la Solicitud del Webhook de Subtítulos ### (Caption Webhook Request Body) La API de Subtítulos permite que una sesión de Wordly en curso envíe subtítulos en vivo a una URL de webhook designada. Los subtítulos seguirán generándose y enviándose hasta que la sesión de Wordly finalice o hasta que la subtitulación se detenga explícitamente usando la API. Se debe proporcionar una URL de webhook al realizar la solicitud para iniciar la subtitulación de una sesión de Wordly. A medida que Wordly genera segmentos de subtítulos, se enviarán a la URL del webhook a través de una solicitud POST. El cuerpo de esta solicitud POST será un único objeto JSON que contiene los siguientes campos. | Campo JSON | Tipo | Descripción | | --- | --- | --- | | ``` sequence ``` | number | El número de secuencia para este segmento de subtítulo define el orden en que deben mostrarse los subtítulos, comenzando con 1. El servicio siempre establecerá esto al valor correcto, y los segmentos de subtítulos se enviarán a la URL del webhook en este orden. Generalmente, los segmentos de subtítulos también llegarán en orden; sin embargo, tenga en cuenta que esto no es una garantía debido a las condiciones de red fuera del control de Wordly. Por lo tanto, el número de secuencia se puede utilizar para verificar la ordenación de los segmentos de subtítulos a medida que llegan. | | ``` language ``` | string | Un código de idioma de Wordly. El texto del subtítulo estará en este idioma. | | ``` text ``` | string | El texto real del subtítulo está formateado según las configuraciones de subtítulos que se proporcionaron cuando se solicitó la subtítulos. | | ``` duration ``` | number | El tiempo que debe mostrarse el subtítulo en milisegundos. | ### IDs de Paquetes de Voz (Voice Pack IDs) Se pueden asignar IDs de paquetes de voz a las sesiones, que son una asignación curada, uno a uno, de voces a los idiomas disponibles para los asistentes de Wordly. Los asistentes que utilicen la aplicación Wordly Web Attend escucharán transcripciones y traducciones utilizando las voces del paquete especificado si eligen usar la función de texto a voz. Actualmente, no hay forma de recuperar programáticamente una lista de los paquetes de voz disponibles. Sin embargo, los siguientes paquetes de voz curados se pueden usar al especificar el ID del paquete de voz para una sesión. | Nombre del Paquete de Voz | ID del Paquete de Voz | | --- | --- | | Voz Femenina | 672def43-f760-451c-82f8-c01711ccaa84 | | Voz Masculina | 97cc30b9-a883-47d5-a2d1-0ad89fc69187 | Si no especifica un paquete de voz al crear una sesión usando la API, la sesión creada utiliza el paquete de voz seleccionado en su perfil de Wordly. Por defecto, su perfil estará configurado para usar el paquete de voz predeterminado, que actualmente es la Voz Femenina. Puede probar los paquetes de voz para diferentes idiomas al [editar una sesión](https://help.wordly.ai/es/editing-a-created-session?hsLang=es) o [actualizar superfil](https://help.wordly.ai/es/changing-default-settings?hsLang=es) en la portada de Wordly. - [El Portada de Wordly](https://help.wordly.ai/es/el-portada-de-wordly?hsLang=es#main-content) - [Navegando en Su Portada](https://help.wordly.ai/es/el-portada-de-wordly?hsLang=es#navegando-en-su-portada) - [Compartir entre Portadas](https://help.wordly.ai/es/el-portada-de-wordly?hsLang=es#compartir-entre-portadas) - [Crear su sesión de Wordly](https://help.wordly.ai/es/crear-su-sesi%C3%B3n-de-wordly?hsLang=es#main-content) - [Conceptos básicos de la sesión](https://help.wordly.ai/es/crear-su-sesi%C3%B3n-de-wordly?hsLang=es#conceptos-b%C3%A1sicos-de-la-sesi%C3%B3n) - [Selección automática de idioma](https://help.wordly.ai/es/crear-su-sesi%C3%B3n-de-wordly?hsLang=es#selecci%C3%B3n-autom%C3%A1tica-de-idioma) - [Cómo organizar una sesión de Wordly](https://help.wordly.ai/es/c%C3%B3mo-organizar-una-sesi%C3%B3n-de-wordly?hsLang=es#main-content) - [Conceptos básicos de hospedaje](https://help.wordly.ai/es/c%C3%B3mo-organizar-una-sesi%C3%B3n-de-wordly?hsLang=es#conceptos-b%C3%A1sicos-de-hospedaje) - [Transcripciones](https://help.wordly.ai/es/c%C3%B3mo-organizar-una-sesi%C3%B3n-de-wordly?hsLang=es#transcripciones) - [Eventos en persona](https://help.wordly.ai/es/c%C3%B3mo-organizar-una-sesi%C3%B3n-de-wordly?hsLang=es#eventos-en-persona) - [Glosarios](https://help.wordly.ai/es/glosarios?hsLang=es) - [Informes](https://help.wordly.ai/es/informes?hsLang=es) - [Integraciones y API](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#main-content) - [Wordly con Sistemas AV](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-con-sistemas-av) - [Wordly para Zoom](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-para-zoom) - [Transmisión a plataformas no integradas](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#transmisi%C3%B3n-a-plataformas-no-integradas) - [Wordly para Cvent](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-para-cvent) - [Wordly para Webex](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-para-webex) - [Wordly para Google Meet](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-para-google-meet) - [Wordly para Microsoft Teams](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#wordly-para-microsoft-teams) - [APIs y Herramientas para Desarrolladores](https://help.wordly.ai/es/integraciones-y-api?hsLang=es#apis-y-herramientas-para-desarrolladores) - [Actualizaciones y lanzamientos de la plataforma](https://help.wordly.ai/es/actualizaciones-y-lanzamientos-de-la-plataforma?hsLang=es) - [Preguntas Frecuentes](https://help.wordly.ai/es/preguntas-frecuentes?hsLang=es) - [Auto-incorporación](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#main-content) - [Trabajo en un lugar de culto que utiliza Wordly para sus servicios semanales](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#trabajo-en-un-lugar-de-culto-que-utiliza-wordly-para-sus-servicios-semanales) - [Uso Wordly para evento presencial: reunión, conferencia o evento](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#uso-wordly-para-evento-presencial-reuni%C3%B3n-conferencia-o-evento) - [Uso Worldly con una plataforma de reuniones o eventos virtuales.](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#uso-worldly-con-una-plataforma-de-reuniones-o-eventos-virtuales) - [Estoy usando Wordly con asistentes tanto presencial como en línea en el mismo evento](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#estoy-usando-wordly-con-asistentes-tanto-presencial-como-en-l%C3%ADnea-en-el-mismo-evento) - [Estoy usando Wordly para conversaciones individuales](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#estoy-usando-wordly-para-conversaciones-individuales) - [Estoy buscando guías de configuración de AV](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#estoy-buscando-gu%C3%ADas-de-configuraci%C3%B3n-de-av) - [Estoy usando Wordly de una manera que no está listada arriba](https://help.wordly.ai/es/auto-incorporaci%C3%B3n?hsLang=es#estoy-usando-wordly-de-una-manera-que-no-est%C3%A1-listada-arriba) - [Asistir sesiones de Wordly](https://help.wordly.ai/es/asistir-sesiones-de-wordly?hsLang=es) [Política de privacidad](https://wordly.ai/privacy-policy) | [Términos de Servicio](https://wordly.ai/wordly-inc-terms-of-service) Derechos de autor © 2026, Wordly, Inc.