Fenicia ofrece herramientas para desarrolladores y usuarios técnicos que necesitan acceso programático a la plataforma o que requieren almacenar credenciales de servicios externos de forma segura.
Las API keys te permiten autenticarte con la API de Fenicia desde aplicaciones externas, scripts de automatización o integraciones personalizadas.
Ve a Configuración → API Keys y haz clic en Generar nueva key.
Asigna un nombre descriptivo que identifique el uso de la key (ej. "Integración ERP", "Script de sincronización").
La key se muestra una sola vez al momento de crearla. Cópiala y guárdala en un lugar seguro.
Seguridad de API Keys
Las API keys otorgan acceso a tu cuenta. Nunca compartas una key en repositorios públicos, correos electrónicos o canales no seguros. Si sospechas que una key fue comprometida, revócala inmediatamente.
Desde el panel de API keys puedes:
| Acción | Descripción |
|---|---|
| Ver keys activas | Lista de todas las keys generadas con su fecha de creación y último uso |
| Revocar key | Invalida inmediatamente una key, cortando el acceso |
| Regenerar key | Crea una nueva key reemplazando la anterior |
Tip
Revisa periódicamente tus API keys activas y revoca las que ya no estén en uso. Esto reduce la superficie de ataque de tu cuenta.
La sección de credenciales te permite almacenar de forma segura las claves de acceso a servicios externos que se integran con Fenicia.
| Tipo | Descripción | Ejemplo |
|---|---|---|
| API Key | Clave simple de autenticación | Servicios de envío, pasarelas de pago |
| OAuth2 | Autenticación con token de acceso y refresh | Marketplaces, redes sociales |
| Bearer Token | Token de portador para APIs REST | Servicios de análisis |
| Basic Auth | Usuario y contraseña codificados | Sistemas legacy, ERPs |
| Custom Headers | Headers personalizados de autenticación | APIs propietarias |
Ve a Configuración → Credenciales y selecciona el tipo de credencial que necesitas almacenar.
Completa los campos requeridos según el tipo: clave, secreto, URL de token, etc.
Usa el botón Probar para verificar que las credenciales son válidas antes de guardar.
Las credenciales se almacenan de forma encriptada y solo se utilizan para las integraciones configuradas.
Fenicia incluye una función de validación que te permite probar tus credenciales sin necesidad de ejecutar una operación completa:
Renovación automática
Para credenciales de tipo OAuth2, Fenicia intenta renovar automáticamente los tokens de acceso antes de que expiren. Si la renovación falla, recibirás una notificación para re-autorizar el servicio.
Las API keys y credenciales habilitan flujos de automatización como: