Claves API

Descripción general

El módulo de claves API ofrece a los usuarios de VillaTax una forma controlada de acceder a la superficie API pública: crear una clave, usarla para autenticar solicitudes, revocarla cuando ya no sea necesaria.

El módulo está en claves API. La especificación API está en documentación de la API.

Qué soporta el módulo

• Crear una nueva clave: generar una clave de acceso vinculada a la cuenta autenticada
• Ver claves existentes: ver qué claves están activas y cuándo se usaron por última vez
• Revocar una clave: desactivar permanentemente cuando una integración se discontinúa

Alcance y propiedad de la API

La API de VillaTax está limitada al usuario. Una sola clave otorga acceso a todas las organizaciones del usuario. La organización puede especificarse como parámetro de filtro en solicitudes individuales.

Por qué importa el acceso API

• Automatización de informes: extraer datos a herramientas de reportes externas sin exportaciones manuales
• Sistemas contables externos: enviar registros de VillaTax a un producto de contabilidad separado
• Paneles personalizados: combinar datos de VillaTax con otras fuentes operativas
• Integración con sistemas de gestión: conectar VillaTax a flujos de trabajo más amplios

Higiene de seguridad

• Las claves solo se muestran al crearlas; después solo son visibles los metadatos
• Si una clave se compromete, puede revocarse inmediatamente sin afectar el inicio de sesión
• Crear una clave separada por contexto de integración es buena práctica

Primeros pasos

Abra claves API cuando una integración necesite acceso programático. Cree la clave, cópiela en el momento de creación, configúrela en el sistema externo. Revóquela cuando la integración ya no esté activa. Consulte documentación de la API para los endpoints disponibles.