Tu archivo,
conectado a tus herramientas.
Un endpoint REST para leer lo que Findest ya ha archivado, y un webhook saliente que se dispara en el momento en que un documento aterriza en tu nube. Sin rastrear tu Drive, sin sondear cada minuto — los datos llegan a ti, firmados para que puedas confiar en ellos.
Un endpoint, todo tu historial.
Genera una clave de API desde Ajustes → Integraciones en la app, y
llama a GET /public-api/documents para obtener los
mismos registros que ves en tu Historial: nombre, tipo detectado,
estado y destino final.
- Autenticación Bearer: una clave por cuenta, mostrada una única vez al crearla
- Revocable cuando quieras: desde la misma pantalla de Ajustes, sin abrir ningún ticket
- Aislada por cuenta: una clave solo devuelve los documentos de esa cuenta
curl \ -H "Authorization: Bearer fk_live_..." \ https://rlarmblikgtxmqlertzg.supabase.co/functions/v1/public-api/documents?limit=50 → 200 OK { "documents": [ { "id": "a1b2c3d4", "filename": "Factura_AcmePower_2026-03-14.pdf", "doc_type": "invoice", "status": "uploaded", "destination": { "folder_name": "facturas_2026" }, "created_at": "2026-03-14T09:12:03Z" } ] }
Entérate en el momento.
Configura una URL de webhook una vez, y cada vez que un
documento se archiva con éxito, Findest le envía un POST
firmado — sin tener que sondear la API cada cierto tiempo.
X-Findest-Signature: 7e5a... (HMAC-SHA256 del cuerpo, con tu secreto de webhook) { "event": "document.archived", "data": { …mismo formato que un documento, arriba… }, "sent_at": "2026-03-14T09:12:04Z" }
Verifica que somos nosotros
Recalcula el HMAC-SHA256 del cuerpo en crudo de la petición con tu
secreto de webhook y compáralo con X-Findest-Signature.
Si no coincide, descarta la petición.
Entrega sin garantía de reintento
Si tu endpoint está caído o tarda demasiado, el archivado en sí sigue funcionando — Findest todavía no reintenta el webhook, así que trátalo como un aviso, no como fuente de verdad (la API sí lo es).
Lo que suele preguntarse.
¿Dónde consigo una clave de API?
En la app, en Ajustes → Integraciones. La clave en claro se muestra una única vez, al crearla — Findest solo guarda su hash, así que apúntala antes de cerrar el diálogo.
¿Hay límite de peticiones?
GET /public-api/documents limita cada
petición a 200 registros. Todavía no hay un límite estricto por
minuto, pero trátalo como un endpoint de lectura para tus propias
integraciones, no como una API pública para terceros.
¿Puedo crear documentos o reglas desde la API?
Todavía no — hoy la API pública es de solo lectura (documentos) más el webhook saliente. Gestionar reglas, conexiones y equipos se hace desde la propia app.
¿El webhook reintenta si mi servidor está caído?
No, la entrega es de un único intento por ahora. Usa la API para recuperar lo que te hayas podido perder, en vez de depender solo del webhook.
Genera tu primera clave de API.
Está en Ajustes → Integraciones, en cualquier plan, lista en un minuto.