Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.meetzy.io/llms.txt

Use this file to discover all available pages before exploring further.

Los tokens API te permiten acceder programáticamente a la API de Meetzy. Estos tokens funcionan como llaves secretas que autentican tus solicitudes automáticamente.
Los tokens API son credenciales sensibles. Nunca los compartas públicamente ni los expongas en código del lado del cliente. Guárdalos de forma segura como variables de entorno.

Gestión de Tokens

Acceder al Gestor de Tokens

  1. Navega a tu Panel de Cuenta
  2. Selecciona API Tokens en el menú lateral
  3. Verás una lista de todos tus tokens activos
El gestor de tokens muestra:
  • Nombre del token: Identificador descriptivo
  • Token enmascarado: Primeros caracteres visibles para identificación
  • Fecha de expiración: Cuándo expira el token
  • Estado: Activo o revocado

Crear un Nuevo Token

1

Abrir modal de creación

Haz clic en el botón “New Token” en la esquina superior derecha del gestor de tokens.
2

Configurar el token

  • Nombre: Asigna un nombre descriptivo (ej: “API Producción”, “Webhook Desarrollo”)
  • Expiración: Selecciona el período de validez:
    • 30 días
    • 90 días
    • 6 meses
    • 1 año
    • Sin expiración (4 años)
3

Validación del nombre

El nombre del token debe:
  • Tener al menos 2 caracteres
  • Ser único en tu cuenta
  • Ser descriptivo para facilitar la gestión
4

Crear y copiar

  1. Haz clic en “Create Token”
  2. Copia inmediatamente el token completo
  3. Guárdalo en un lugar seguro
El token completo solo se muestra una vez por seguridad. Si no lo copias ahora, tendrás que crear uno nuevo.

Estado Después de la Creación

Una vez creado exitosamente, verás:
  • Icono de éxito y nombre del token
  • ⚠️ Advertencia de seguridad destacada
  • 🔑 Token completo en formato copiable
  • 📋 Botón “Copy” que cambia a “Copied!” tras el clic

Información Importante

  • El token se agrega automáticamente a tu lista
  • El modal permanece abierto para que copies el valor
  • Puedes cerrar el modal haciendo clic fuera o en el botón cerrar

Revocar Tokens

Proceso de Revocación

1

Identificar el token

En la lista de tokens, localiza el que deseas revocar.
2

Iniciar revocación

Haz clic en el icono de papelera (🗑️) que aparece al pasar el cursor sobre el token.
3

Confirmar acción

Se abrirá un modal de confirmación mostrando:
  • Nombre del token a revocar
  • Advertencia sobre la irreversibilidad
  • Botones “Cancel” y “Revoke Token”
4

Completar revocación

Haz clic en “Revoke Token” para confirmar. El token será eliminado inmediatamente.
La revocación de tokens es inmediata e irreversible. Todas las solicitudes API que usen ese token fallarán instantáneamente.

Funciones de la Interfaz

Copiado Rápido

  • Icono de copia (📋) junto a cada token enmascarado
  • Feedback visual: el botón cambia a “Copied!” con ícono de check
  • Copia automática al portapapeles del sistema

Tokens Enmascarados

Los tokens se muestran parcialmente para seguridad:
sk_live_abcdef123456789••••••••••••••••
  • Primeros 24 caracteres visibles para identificación
  • Resto oculto con puntos para protección

Estados Visuales

  • Punto verde: Token activo
  • Hover effects: Resaltan las acciones disponibles
  • Contador: “X active token(s)” en el footer

Estado Vacío

Cuando no tienes tokens configurados:
  • Ilustración central con ícono de llave
  • Mensaje guía: “No tokens yet”
  • Descripción: Explica el propósito de los tokens
  • CTA prominente: “Create your first token”

Mejores Prácticas

Gestión Segura de Tokens:
  • Usa nombres descriptivos que indiquen el propósito
  • Establece fechas de expiración apropiadas
  • Revoca tokens no utilizados regularmente
  • Nunca hardcodees tokens en tu código fuente

Organización Recomendada

  • Producción: api-prod-2024 - Sin expiración
  • Desarrollo: api-dev-enero - 90 días
  • Testing: api-test-temp - 30 días
  • Webhooks: webhook-payments - 1 año

Rotación de Tokens

  1. Crea un nuevo token antes de que expire el anterior
  2. Actualiza todas las integraciones con el nuevo token
  3. Verifica que funcionen correctamente
  4. Revoca el token anterior
El sistema te notificará cuando los tokens estén próximos a expirar para facilitar la rotación proactiva.