# Usar el acceso a la API

> Crea tokens de acceso personal para scripts y clientes MCP, y envía los eventos de tu Livespace a tus propios sistemas mediante webhooks.

En Ajustes › **Acceso a la API**, puedes crear tokens de acceso personal para que un script o un cliente MCP use Dvina en tu nombre. Los administradores también pueden añadir webhooks desde ahí para enviar los eventos del Livespace a sus propios sistemas.

El acceso a la API está incluido en el plan Enterprise. Cada miembro puede crear sus propios tokens; solo los propietarios y administradores ven **Webhooks**.

## Crear un token

1. Abre Ajustes y elige **Acceso a la API**.
2. En **Tokens de acceso personal**, elige **Crear token**.
3. Introduce un **Nombre** para identificar más adelante qué lo usa.
4. Elige el **Acceso**: **Solo lectura** o **Lectura y escritura**.
5. Elige cuándo **Caduca**: **En 30 días**, **En 90 días**, **En 365 días** o **Nunca caduca**.
6. Elige **Crear token**.
7. En **Copia tu token**, copia el token y guárdalo en un lugar seguro. Solo se muestra esta vez.

Un token actúa en tu nombre, en el Livespace donde lo creaste y con el rol que tengas allí en ese momento. Un token de **Solo lectura** puede leer, pero no puede añadir ni cambiar nada.

Para usar un token con un cliente MCP, consulta [Conectar con una clave de API en lugar de OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Consultar, rotar o revocar un token

Tus tokens aparecen en **Tokens de acceso personal**, junto con su nivel de acceso. Elige uno para ver por qué caracteres **Empieza**, su **Acceso**, cuándo fue su **Último uso** y cuándo **Caduca**.

- **Para sustituir un token**, elige **Rotar…** y luego **Rotar** para confirmar. Un nuevo token lo sustituye y el anterior deja de funcionar de inmediato. Copia el nuevo token en **Copia tu token**.
- **Para desactivar un token**, elige **Revocar…** y luego **Revocar** para confirmar. Todo lo que lo use deja de funcionar de inmediato.

La creación, rotación y revocación de tokens quedan registradas en el [registro de auditoría](/docs/teams/audit-log).

## Añadir un webhook

Un webhook envía los eventos del Livespace, los mismos registros que aparecen en el [registro de auditoría](/docs/teams/audit-log), a la dirección que elijas.

1. En Ajustes › **Acceso a la API**, dentro de **Webhooks**, elige **Añadir webhook**.
2. Introduce un **Nombre** y la **URL**. Usa una URL HTTPS pública.
3. En **Eventos**, deja el campo vacío para recibir todos los eventos o indica acciones y áreas, como `member.added` o `sharing.*`.
4. Elige **Añadir**.
5. En **Copia el secreto de firma**, copia el secreto. Solo se muestra esta vez.

Si Dvina indica **No se puede acceder a esta dirección desde Dvina**, usa una URL HTTPS pública.

### Comprobar la firma de cada solicitud

Dvina envía los eventos por lotes, en formato JSON, y firma cada solicitud. Usa el secreto de firma para comprobar que una solicitud proviene de Dvina:

- Cada solicitud incluye una cabecera `X-Dvina-Signature` con un valor como `t=<timestamp>,v1=<signature>`.
- La firma es un HMAC-SHA256, en hexadecimal, de la marca de tiempo, un punto y el cuerpo de la solicitud, generado con tu secreto de firma.
- Calcúlala y compárala con la recibida. Rechaza cualquier solicitud cuya firma no coincida o cuya marca de tiempo sea demasiado antigua.

## Consulta o modifica un webhook

Tus webhooks aparecen en **Webhooks** con su estado: **Activo**, **En pausa** o **Con errores**. Selecciona uno para ver sus detalles.

- **Para modificarlo**, edita su **Nombre**, **URL** o **Eventos** y selecciona **Guardar**.
- **Para pausarlo**, desactiva **Enviar eventos**. Vuelve a activarlo para reanudar el envío.
- **Para comprobar cómo funciona**, consulta su **Estado** y cuántos eventos se han **Enviado**. Si un webhook falla, muestra su **Último error**. Dvina sigue intentándolo y registra el fallo en el registro de auditoría.
- **Para cambiar su secreto**, selecciona **Nuevo secreto de firma…** y confirma. Las solicitudes se firman con el nuevo secreto de inmediato, así que actualiza el receptor enseguida.
- **Para eliminarlo**, selecciona **Eliminar…** y luego **Eliminar** para confirmar. No se le enviará nada más.

## Contenido relacionado

- [Usa Dvina desde otras aplicaciones con MCP](/docs/dvina-mcp/overview)
- [Usa el registro de auditoría](/docs/teams/audit-log)
- [Descripción general de los equipos](/docs/teams/overview)