Para generar y administrar los tokens de autenticación, sigue los pasos a continuación, utilizando la interfaz de wolkvox Manager.

Proceso para Crear un Token

Para crear un nuevo token, debes acceder a la configuración de integraciones dentro de wolkvox Manager.

1. Ingresa a wolkvox Manager.
   1. Haz clic en el ícono de Configuración (engranaje), ubicado en el menú superior derecho de la aplicación.
2. En la ventana emergente de "Configuración", navega y selecciona la pestaña principal de Integraciones.
3. Dentro de esta sección, haz clic en la sub-pestaña Tokens.
4. En el campo "Descripción del token", escribe un nombre o descripción clara que te permita identificar el uso del token. Este campo es obligatorio.
5. Presiona el botón “Adicionar token”.
6. Inmediatamente, el nuevo token se listará en la tabla inferior, mostrando el token mismo, su descripción, el conteo de uso del día y el límite total de consumo.

Gestión de Tokens Existentes

Una vez que los tokens están creados y listados en la tabla, puedes gestionarlos fácilmente. Haz clic derecho sobre un token específico en la lista para desplegar las siguientes opciones:

• Copiar Token: Copia el valor alfanumérico del token a tu portapapeles. Es la forma recomendada para evitar errores de transcripción.
• Borrar: Elimina permanentemente el token seleccionado. Esta acción no se puede deshacer.
• Refrescar: Actualiza la lista de tokens en la tabla. Es útil si no ves un token recién creado o si quieres actualizar los contadores de uso.

Cómo Utilizar el wolkvox-token

Para autenticar tus solicitudes a la API, debes enviar el token generado como un encabezado (header) en tu petición HTTP de la siguiente manera:

• Nombre del encabezado: wolkvox-token
• Valor del encabezado: [El token que copiaste desde wolkvox Manager]

Consideración Importante: Mantenimiento del Servidor

Es importante tener en cuenta que durante los procesos de mantenimiento, como la creación de copias de seguridad en el servidor, el consumo de APIs se deshabilita temporalmente para garantizar la integridad de los datos.

Si intentas consumir una API durante este intervalo, recibirás la siguiente respuesta con un código de estado 403 Forbidden:

{
  "code": "403",
  "error": "Forbidden",
  "msg": "The APIs cannot be consumed at this time, try again later."
}

Esta es una respuesta controlada y esperada. Tu desarrollo debe estar preparado para manejar este escenario y reintentar la solicitud más tarde.