> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Token expired

> Este evento se activa cuando un Token ID expira según las condiciones de expiración configuradas. Puede gestionar tokens basándose en el conteo de uso o el tiempo a través de la configuración de Token Expiration, y los webhooks se envían automáticamente cuando los tokens expiran. Esto le permite rastrear el ciclo de vida del token y prevenir problemas de reutilización de tokens.

<Note>
  * Los webhooks de expiración de Token ID solo se envían cuando la configuración de Token Expiration está habilitada en su proyecto.
  * La expiración de tokens puede configurarse basada en conteo o basada en tiempo.
</Note>

## Tipos de Token ID y conceptos de expiración

### Token pre-registrado

Un método en el que su sistema genera Token IDs de antemano.

<Info>
  * Los tokens expiran inmediatamente después de un único envío.
  * Existe un concepto explícito de expiración.
</Info>

### Token no registrado

Un método que utiliza tokens sin generación previa.

<Info>
  * Los tokens no tienen una expiración explícita.
  * La validez se verifica basándose en el uso previo al momento de utilizarlos.
</Info>

## Configuración de expiración de tokens

La entrega de webhooks depende de si la configuración de Token Expiration está habilitada en su proyecto.

<Tabs>
  <Tab title="Basada en conteo">
    Gestiona la expiración de tokens basándose en el conteo de uso.

    **Ejemplo**: Expira después de 1 uso
  </Tab>

  <Tab title="Basada en tiempo">
    Gestiona la expiración de tokens basándose en el tiempo.

    **Ejemplo**: Expira después de 24 horas
  </Tab>
</Tabs>

## Ejemplos de webhook

<CodeGroup>
  ```json token-expired-count-based.json theme={null}
  {
    "webhook_trigger": "token_expired",
    "token_id": "tok_abc123def456",
    "expired_condition": "count",
    "expired_at": "2025-11-12T02:23:13.588Z",
    "service": "idCheck"
  }
  ```

  ```json token-expired-time-based.json theme={null}
  {
    "webhook_trigger": "token_expired",
    "token_id": "tok_xyz789ghi012",
    "expired_condition": "time",
    "expected_expired_at": "2025-11-12T02:23:13.588Z",
    "service": "idCheck"
  }
  ```
</CodeGroup>

## Campos de respuesta

<ResponseField name="webhook_trigger" type="string">
  Tipo de trigger del webhook - `token_expired` indica que el Token ID ha expirado
</ResponseField>

<ResponseField name="token_id" type="string">
  El Token ID expirado
</ResponseField>

<ResponseField name="expired_condition" type="string">
  La condición de validación de expiración configurada

  * `count`: Expiración basada en conteo
  * `time`: Expiración basada en tiempo
</ResponseField>

<ResponseField name="service" type="string">
  Servicio objetivo - `idCheck` (pipeline principal de ID Check)
</ResponseField>

<ResponseField name="expired_at" type="string">
  Marca temporal de expiración (formato ISO 8601)

  <Info>
    Solo se incluye cuando `expired_condition` es `count`. Indica el momento exacto en que el token expiró.
  </Info>
</ResponseField>

<ResponseField name="expected_expired_at" type="string">
  Marca temporal de expiración esperada (formato ISO 8601)

  <Info>
    Solo se incluye cuando `expired_condition` es `time`. Indica cuándo estaba programado que el token expirara.
  </Info>
</ResponseField>

## Casos de uso

Los webhooks de expiración de Token ID son útiles en los siguientes escenarios:

<AccordionGroup>
  <Accordion title="Prevenir la reutilización de tokens">
    Detecte tokens expirados para bloquear intentos de reutilización y registrar eventos de seguridad.
  </Accordion>

  <Accordion title="Rastrear lógica de servicio">
    Rastree el ciclo de vida del token para analizar flujos de usuario y mejorar la calidad del servicio.
  </Accordion>

  <Accordion title="Gestión automatizada de tokens">
    Genere automáticamente nuevos tokens o envíe notificaciones a los usuarios basándose en eventos de expiración.
  </Accordion>
</AccordionGroup>

<Tip>
  Aprovechar los webhooks de expiración de Token ID puede mejorar significativamente la seguridad y la trazabilidad de sus flujos basados en tokens.
</Tip>