retention en cada petición (de none, 15
minutos, a 90d) o bórralos tú con DELETE /documents/{id} en cuanto los descargues.
Pasos
- Guarda tu API key en
DOCONDA_API_KEYe instala el SDK (pip install docondaonpm install @doconda/sdk). - Crea el documento con la retención más corta que te sirva.
- Descárgalo y bórralo, junto con los ficheros que subiste.
files.delete(id).
Qué valores admite retention
No hay «para siempre». Para todo un proyecto se elige en el panel, en Organización → Proyectos → Se guarda; vale
también para los ficheros que subas con
POST /files.
Qué devuelve
- El documento lleva
retentionyexpires_at: cuándo se borrará su contenido (se fija al terminar). - Al borrarse, el documento muestra
content_deleted_at, y/reporty/eventsresponden410 content_deleted. - Se borran los ficheros (Word, PDF, imágenes), tu petición, el informe, los eventos y el
metadata. Queda solo lo necesario para cobrar: estado, formato, tipo, páginas y coste.
Límites
- Un artifact con
retention: "none"no puede guardar datos compartidos: los guarda en el navegador de cada visitante. - Los enlaces de descarga caducan a los 5 minutos;
documents.outputs(id)da otros mientras el documento exista.
Preguntas frecuentes
¿Leer un fichero a Markdown guarda algo?
¿Leer un fichero a Markdown guarda algo?
No.
extract no tiene retención: Doconda no guarda nada una vez te ha dado el texto, y si no
lo recoges lo borra a los 15 minutos.¿Cómo me llevo cada documento en cuanto termina?
¿Cómo me llevo cada documento en cuanto termina?
Con los webhooks: te avisan al terminar y lo descargas a tu sistema.
¿Qué API uso desde Europa?
¿Qué API uso desde Europa?
Todas las API keys (
ak_eu_…) van contra https://api.eu.doconda.com/v1.