API & webhook settings
Esta función está disponible para todos los usuarios en todos los planes de suscripción.
Clockify allows you to manage and configure advanced settings for your profile such as webhooks y API keys. This way get more control over your account’s security and efficiency.
API keys #
Es importante guardar tus claves API en un lugar seguro. Si pierdes una clave o no la guardas, generar una nueva desactivará la anterior, lo que podría afectar las configuraciones e integraciones existentes.
En Clockify, puedes guardar tus claves API y editarlas según sea necesario.
Encuentra la configuración de tu clave API en la pestaña Avanzado de la Configuración de perfil.
Haz clic en el botón Gestionar claves API y verás una lista de todas las API que has generado en la página que se abre.
Aquí puedes gestionar tus claves API de diferentes maneras.
Generar clave API
Para crear una clave nueva:
- Haz clic en Generar nueva en la esquina superior derecha de la página
- Se abrirá la ventana Generar clave API
- Introduce un nombre para tu nueva clave API
Asigna un nombre descriptivo para que sepas para qué sirve. - Haz clic en Generar
Tu nueva clave se creará automáticamente y se añadirá a la lista de la página Gestionar claves API.
Editar la clave API
Si necesitas realizar cambios en la clave API:
- Haz clic en el menú de tres puntos junto a la clave API que quieres deshabilitar
- Selecciona la opción Cambiar nombre/Eliminar option
- Introduce el nuevo nombre o haz clic en Eliminar para confirmar
El nombre de la nueva clave API se actualiza automáticamente en la página Gestionar claves API.
Tras eliminarla, ya no podrá utilizarse y se eliminará automáticamente de la página Gestionar claves API y de la pestaña Cuentas en la Configuración del espacio de trabajo.
Webhooks #
Crea webhooks para recibir notificaciones y actualizaciones de datos en tiempo real.
Esta función está disponible para los propietarios y administradores del espacio de trabajo. La sección Webhooks no es visible para otros roles de usuario.
Sigue estos pasos:
- Ve a Preferencias
- Selecciona la pestaña Avanzado
- En la sección Webhooks, haz clic en Gestionar webhooks
- Saltarás a la página de Webhooks
Si formas parte de varios espacios de trabajo, elige el espacio de trabajo correspondiente.
Para crear un nuevo webhook:
- Haz clic en el botón Crear nuevo en la esquina superior derecha
- In the Create webhook window, provide the following details:
Name: Specify a name for your webhook
Endpoint: Enter the webhook’s endpoint URL
Event: Choose the event that will trigger the webhook - Haz clic en Crear para completar el proceso
Si formas parte de varios espacios de trabajo, elige el espacio de trabajo correspondiente.
Los eventos de webhook creados se ordenan en orden alfabético.
Un evento webhook se puede desactivar durante su creación, si el espacio de trabajo de Clockify no está en el plan de suscripción que tiene esta función.
Detalles de webhook #
Si te gustaría ver los detalles de webhook, puedes hacerlo abriendo el menú de tres puntos en ese webhook.
- Ve al webhook que te gustaría examinar
- Abre Detallesen el menú de tres puntos
- Se abre una nueva página con la lista de Intentos de webhook
Aquí puedes ver la fecha del intento y el estado del evento.
Consejo: La fecha del intento sigue el formato establecido en las preferencias.
El webhook de prueba también puede aparecer en los intentos de webhook con el estado y carga correspondientes.
Editar webhook #
Si te gustaría modificar algun dato relacionado con los webhooks, puedes hacerlo seleccionando la opción de edición.
- Ve al webhook que te gustaría eliminar
- Selecciona Editar en el menú de tres puntos
- Se abre una nueva página con la lista de Intentos de webhook
Aquí puedes modificar todos los elementos del webhook creado:
- Cambiar el nombre del webhook
- Cambiar la URL del punto de conexión
- Seleccionar otro evento del desplegable
- Cambiar (restablecer) el Secreto de firma
Eliminar webhook #
Si te gustaría eliminar un webhook obsoleto o sin uso, puedes hacerlo así:
- Ve al webhook que te gustaría eliminar
- Selecciona Eliminar en el menú de tres puntos
- Haz clic en Eliminar en la ventana de confirmación
Webhooks de Marketplace #
Los usuarios del complemento no disponen de un botón Reenviar en los intentos de webhook del complemento.