Visão Geral
Esta API converte documentos para JSON ou Markdown usando Docling. Imagens e documentos são processados pelo conversor Docling padrão. Áudios são transcritos via Whisper.
Autenticação
Rotas abertas para testes locais. Em produção, configure um gateway/autenticação.
Login
Não requerido nesta versão.
Registro
Não requerido nesta versão.
Login por Telefone
Não requerido nesta versão.
Reset de Senha
Não requerido nesta versão.
Base URL
http://127.0.0.1:5000 (dev) | https://docs.konecta.pro (prod)
Códigos de Erro
200 OK | 400 Requisição inválida | 404 Não encontrado | 500 Erro interno
POST /api/documents/upload
Fazer upload e processar um documento usando Docling
Requisição
curl -X POST https://docs.konecta.pro/api/documents/upload -H "Content-Type: multipart/form-data" -F "file=@documento.pdf" -F "output_format=json" -F "pipeline=default"
Upload de Imagem
curl -X POST https://docs.konecta.pro/api/documents/upload -H "Content-Type: multipart/form-data" -F "file=@imagem.jpg" -F "output_format=markdown" -F "ocr_mode=hybrid" -F "tess_lang=por+eng" -F "tess_psm=6" -F "tess_oem=3" -F "tess_pre=standard"
Upload de Áudio (Transcrição)
curl -X POST https://docs.konecta.pro/api/documents/upload -H "Content-Type: multipart/form-data" -F "file=@audio.mp3" -F "output_format=json"
POST /api/documents/process-url
Processar documento a partir de uma URL
Requisição
curl -X POST https://docs.konecta.pro/api/documents/process-url -H "Content-Type: application/json" -d '{
"url": "https://arxiv.org/pdf/2408.09869",
"output_format": "markdown",
"pipeline": "default"
}'
URL de Imagem
curl -X POST https://docs.konecta.pro/api/documents/process-url -H "Content-Type: application/json" -d '{
"url": "https://exemplo.com/imagem.jpg",
"output_format": "json",
"ocr_mode": "tesseract",
"tess_lang": "por+eng",
"tess_psm": 6,
"tess_oem": 3,
"tess_pre": "standard"
}'
URL de Áudio (Transcrição)
curl -X POST https://docs.konecta.pro/api/documents/process-url -H "Content-Type: application/json" -d '{
"url": "https://exemplo.com/audio.mp3",
"output_format": "markdown"
}'
GET /api/documents
Listar todos os documentos processados
Requisição
curl -X GET https://docs.konecta.pro/api/documents
GET /api/documents/:filename
Retorna metadados de um documento específico
Requisição
curl -X GET https://docs.konecta.pro/api/documents/exemplo_20250101_120000.json
GET /api/documents/download/:filename
Download do arquivo processado
Requisição
curl -X GET https://docs.konecta.pro/api/documents/download/exemplo_20250101_120000.json
GET /api/documents/view/:filename
Visualiza o arquivo processado inline no navegador (JSON/Markdown).
Requisição
curl -X GET https://docs.konecta.pro/api/documents/view/exemplo_20250101_120000.md
POST /api/admin/cleanup
Executa limpeza manual de documentos antigos (retenção)
Requisição
curl -X POST "https://docs.konecta.pro/api/admin/cleanup?days=7"
GET /health
Status da API
Requisição
curl -X GET https://docs.konecta.pro/health