Integraciones
Fynex ofrece múltiples formas de conectar tus sistemas externos con la plataforma. Podés sincronizar datos de cuentas, recibir notificaciones en tiempo real y acceder a toda la funcionalidad de forma programática.
¿Qué podés integrar?
| Capacidad | Descripción |
|---|---|
| Importación CSV/Excel | Cargá cuentas y contactos desde archivos desde la interfaz del Portfolio. |
| API REST | Creá, actualizá y consultá cuentas, contactos, pagos e interacciones vía endpoints HTTP. |
| Webhooks | Recibí notificaciones POST en tu servidor cuando ocurren eventos (pagos, promesas, etc.). |
| Exportación | Exportá datos de cuentas en formato JSON o CSV, con filtros por estado, fecha y origen. |
Primeros pasos
- Creá una clave API — Andá a Configuración > Integraciones y generá una clave. Consultá la guía de Claves API.
- Configurá webhooks — Registrá una URL para recibir eventos en tiempo real. Consultá la guía de Webhooks.
- Empezá a sincronizar datos — Usá la API para importar cuentas o registrar pagos. Consultá la guía de Importación y exportación.
Autenticación
La API v1 de Fynex acepta dos métodos de autenticación:
| Método | Header | Uso típico |
|---|---|---|
| API Key | X-API-Key: fynex_pk_... | Integraciones servidor-a-servidor |
| JWT | Authorization: Bearer ... | Aplicaciones que usan Supabase Auth |
Las claves API tienen scopes que limitan qué operaciones pueden realizar. El JWT hereda los permisos del usuario autenticado.
TIP
Para integraciones automatizadas (cron jobs, sincronización con tu ERP, etc.), usá claves API. Reservá JWT para aplicaciones interactivas.
Base URL
| Entorno | URL |
|---|---|
| Producción | https://api.fynex.solutions |
| Desarrollo | http://localhost:3001 |
Todos los endpoints de integración están bajo el prefijo /api/v1/.
Recursos de la API
| Recurso | Endpoint base | Scopes requeridos |
|---|---|---|
| Cuentas | /api/v1/accounts | accounts:read, accounts:write |
| Contactos | /api/v1/contacts | contacts:read, contacts:write |
| Pagos | /api/v1/payments | payments:write |
| Importación | /api/v1/import | import |
| Exportación | /api/v1/export | export |
| Webhooks | /api/v1/webhooks | webhooks:manage |
| Interacciones | /api/v1/interactions | accounts:read |
Límites de tasa
Todas las peticiones a la API están sujetas a un límite de 100 peticiones cada 15 minutos por clave API. Si excedés el límite, vas a recibir un error 429 Too Many Requests.
Guías relacionadas
- Claves API — Cómo crear y administrar claves.
- Webhooks — Cómo recibir eventos en tiempo real.
- Importación y exportación vía API — Cómo sincronizar datos de forma programática.
- API Reference — Referencia completa de todos los endpoints.