@zeetechsolutions/solutions
v1.0.0
Published
Guía para integrar visores vía <iframe> (transcodificador, OCR, editor NER) con auth básica.
Maintainers
Readme
📦 Integración de Visores vía <iframe>
Este documento explica cómo subir archivos, consultar su estado/URL y mostrar resultados dentro de un <iframe> para tres servicios:
🎥 Transcodificador (video → audio → transcripción)
📄 OCR (PDF/imagen → texto)
✍️ Editor (procesamiento de texto)
Todos los servicios comparten el mismo flujo:
Autenticación básica en los endpoints (usuario + token).
Subir el archivo al endpoint de carga.
Consultar el recurso para obtener la URL.
Renderizar la URL dentro de un
<iframe>.
1. 🎥 Transcodificador
Función: Convierte videos MP4 en texto transcrito, mostrando el video sincronizado con subtítulos.
Seguridad: Autenticación básica (usuario + token).
Compatibilidad: Navegadores modernos; se recomienda MP4.
2. 📄 OCR
Función: Convierte PDFs o imágenes (JPG/PNG) en texto editable y buscable.
Seguridad: Autenticación básica (usuario + token).
Compatibilidad: Navegadores modernos; soporta PDF, JPG y PNG.
3. ✍️ Editor NER
Función: Identifica entidades nombradas (personas, lugares, organizaciones, fechas, etc.) en texto y las muestra en un editor interactivo.
Seguridad: Autenticación básica (usuario + token).
Compatibilidad: Navegadores modernos; entrada de texto o JSON.
🔐 Autenticación
Tipo: Básica (HTTP Basic Auth)
Enviar el header:
Authorization: Basic <base64(user:token)>
📄 Ejemplo OCR (PDF/JPG/PNG)
Docs: https://ocr.zeetech.com.mx/api/docs
Endpoints
POST /api/api-files/upload
GET /api/api-files/get/{url}
Respuesta esperada:
{
"_id": "***************",
"src": "https://********/archivo.pdf?X-Amz-Algorithm=***&X-Amz-Signature=***",
"mimetype": "application/pdf",
"status": "SUCCESS",
"createdAt": "2025-04-24T19:16:58.056Z",
"updatedAt": "2025-04-24T19:18:13.521Z",
"urlModal": "https://********/file/***************"
}
🖼️ Embebido con <iframe>
<iframe
src="${urlModal}"
style="width:100%; height:80vh; border:0;"
loading="lazy"
></iframe>
🎥 Ejemplo Transcodificador (MP4)
Docs: https://transcripcion.zeetech.com.mx/api/docs
Endpoints
POST /api/api/transcriptor/create
GET /api/api/video/{id}Respuesta esperada:
{
"_id": "***************",
"status": "SUCCESS",
"video": "https://********/video.mp4?X-Amz-Signature=***",
"srt": "https://********/video.srt?X-Amz-Signature=***",
"vtt": "https://********/video.vtt?X-Amz-Signature=***",
"json": "https://********/video.json?X-Amz-Signature=***",
"mod": "large",
"user": "***************",
"createdAt": "2025-08-04T18:14:22.337Z",
"updatedAt": "2025-08-04T18:14:22.337Z",
"name": "Simulacro de audiencia.mp4",
"url": "https://********/video/***************?token=***"
}
🖼️ Embebido con <iframe>
<iframe
src="${url}"
style="width:100%; height:80vh; border:0;"
loading="lazy"
allowfullscreen
></iframe>
🎥 Ejemplo Editor - NER
Docs: https://ner.zeetech.com.mx/api/docs
Endpoints
Se hace el POST del link del documento en formato DOCX, el cual debe ser accesible, esto mediante un socket a:
POST /api/queuesPosteriormente, una vez finalice la tarea, devolverá un arreglo con los nombres a testar.
