Claves de API

Autentica las solicitudes API con claves de API seguras.

Descripción General

Las claves de API te permiten:

• Autenticar solicitudes API
• Integrar con sistemas externos
• Automatizar flujos de trabajo de solicitud de fotos
• Construir aplicaciones personalizadas

Requisito de Plan

El acceso a API requiere un plan que incluya características de API.

Crear una Clave de API

Pasos

1. Ve a Claves de API en la barra lateral
2. Haz clic en Crear Clave de API
3. Introduce un nombre descriptivo
4. Activa Activa (predeterminado: activado)
5. Haz clic en Crear

Guarda Tu Clave

Visualización Única

La clave de API completa se muestra solo una vez en la creación. Cópiala y almacénala de forma segura. No puedes recuperarla después.

Después de la creación:

• Copia la clave inmediatamente
• Almacena en una ubicación segura
• Nunca compartas públicamente

Usar Claves de API

Cabecera de Autenticación

Incluye la clave de API en las cabeceras de solicitud:

curl -X GET "https://api.visio.now/v1/status" \
  -H "X-API-Key: tu-clave-api-aqui"

Nombre de Cabecera

Cabecera	Valor
X-API-Key	Tu clave de API

Solicitud de Ejemplo

# Crear una solicitud de fotos
curl -X POST "https://api.visio.now/v1/photo-requests" \
  -H "X-API-Key: vsk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Por favor envía fotos del vehículo",
    "photo_slots": [
      {"instructions": "Vista frontal", "is_required": true},
      {"instructions": "Vista trasera", "is_required": true}
    ]
  }'

Gestionar Claves de API

Ver Claves

La lista de Claves de API muestra:

• Nombre de la clave
• Clave enmascarada (visualización parcial)
• Estado activo/inactivo
• Fecha de último uso
• Fecha de creación

Editar Clave

1. Haz clic en el icono de editar
2. Actualiza el nombre
3. Activa/desactiva el estado activo
4. Guarda los cambios

Desactivar Clave

Deshabilita temporalmente una clave:

1. Haz clic en Desactivar en la clave
2. Confirma la acción
3. La clave deja de funcionar inmediatamente

Activar Clave

Vuelve a habilitar una clave desactivada:

1. Haz clic en Activar en la clave
2. Confirma la acción
3. La clave funciona de nuevo inmediatamente

Regenerar Clave

Crea un nuevo valor de clave:

1. Haz clic en Regenerar
2. Confirma la acción (la clave antigua deja de funcionar)
3. Copia la nueva clave inmediatamente

Invalidación Inmediata

Regenerar invalida la clave antigua instantáneamente. Actualiza todas las integraciones antes de regenerar.

Eliminar Clave

Elimina permanentemente una clave:

1. Haz clic en Eliminar
2. Confirma la acción
3. La clave se elimina permanentemente

Formato de Clave de API

Las claves siguen este formato:

vsk_[entorno]_[cadena-aleatoria]

Prefijo	Entorno
vsk_live_	Producción
vsk_test_	Pruebas

Mejores Prácticas de Seguridad

Almacenamiento de Claves

• Almacena en variables de entorno
• Usa sistemas de gestión de secretos
• Nunca commits al control de versiones
• No incluyas en código del lado del cliente

Rotación de Claves

• Rota las claves periódicamente
• Rota inmediatamente si está comprometida
• Usa claves de corta duración para pruebas

Control de Acceso

• Crea claves separadas por integración
• Usa nombres descriptivos
• Monitorea el uso de claves
• Desactiva claves no usadas

Qué NO Hacer

• Compartir claves en emails
• Publicar claves en chat/Slack
• Incluir en URLs
• Almacenar en archivos de texto plano

Límites de Tasa

Las solicitudes API tienen límites de tasa:

Límite	Valor
Por minuto	60 solicitudes
Por hora	1,000 solicitudes

Cabeceras de Límite de Tasa

Las respuestas incluyen:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1609459200

Límite Excedido

Cuando se excede:

• Respuesta HTTP 429
• Reintenta después del tiempo indicado
• Implementa retroceso exponencial

Solución de Problemas

401 No Autorizado

Causas:

• Clave de API inválida
• Clave está desactivada
• Clave fue eliminada/regenerada
• Cabecera faltante

Soluciones:

1. Verifica que la clave sea correcta
2. Comprueba que la clave esté activa
3. Regenera si es necesario

403 Prohibido

Causas:

• La clave no tiene permiso
• Característica no en el plan
• Restricciones del espacio de trabajo

Soluciones:

1. Verifica características del plan
2. Verifica propiedad de la clave
3. Contacta soporte

Clave No Se Muestra

Si perdiste tu clave:

1. La original no puede recuperarse
2. Regenera para obtener una nueva
3. Actualiza todas las integraciones

Límites de Claves

Por Plan

Plan	Máximo de Claves de API
Professional	5 claves
Enterprise	Ilimitadas

Recomendaciones

• Producción: 1 clave por integración
• Desarrollo: Claves de prueba separadas
• CI/CD: Clave de despliegue dedicada

Páginas Relacionadas

• Referencia de API - Documentación completa de API
• Webhooks - Notificaciones en tiempo real
• Integraciones - Integraciones preconstruidas