API

Escriba espone una piccola API REST, comoda per l’automazione (n8n, script). L’autenticazione è sempre obbligatoria.

Autenticati

Con un token API (definisci API_TOKEN):

curl -H "X-API-Key: YOUR_TOKEN" \
   -F "file=@document.pdf" \
   https://your-domain/api/convert
# Force OCR / set language:  -F "ocr=true"  -F "lang=es-ES"

Con un cookie di sessione:

curl -c cookies.txt -F "password=$GOD_PASSWORD" https://your-domain/api/login
curl -b cookies.txt -F "file=@document.pdf"     https://your-domain/api/convert

Convert

POST /api/convert (multipart/form-data): file oppure url, più gli opzionali lang, ocr, pages, llm_provider, llm_api_key, llm_model. Risposta:

{ "source": "…", "title": "…", "markdown": "…",
"words": 1234, "chars": 5678, "elapsed_ms": 87,
"pdf_type": "scanned", "ocr_applied": true, "note": null }

Redact

POST /api/redact (multipart/form-data): file (PDF o immagine), opzionali lang, anon_strict, anon_detectors, anon_rules. Restituisce il PDF redatto (binario) con l’header X-Redacted-Entities che conta ciò che è stato oscurato.

Post-elaborazione del Markdown

JSON in ingresso, JSON o file in uscita:

Endpoint	Metodo	Descrizione
`/api/export`	POST	Converti il Markdown in un formato di destinazione (`docx`, `odt`, `epub`, `html`, `latex`, `rst`, `docbook`, `jats`, `tei`, `opml`).
`/api/compact`	POST	Markdown con gli spazi rimossi per risparmiare token.
`/api/chunk`	POST	Chunk RAG limitati per token (restituisce `.jsonl`).
`/api/model_prices`	GET	Prezzi dei modelli e finestre di contesto in tempo reale (OpenRouter, in cache).