Convert File FastAPI
Construimos una API que recibe un archivo y lo devuelve convertido en la misma respuesta. Esta página no es para venderla: es el relato del problema que nos llevó a escribirla.
Un párrafo con los hechos, para que nadie tenga que adivinar de qué estamos hablando.
Convert File Fast es una API. Un sistema envía un archivo en una solicitud y recibe de vuelta el archivo convertido en la respuesta de esa misma llamada, sin una cola que consultar después. Son más de sesenta tipos de conversión entre documentos, hojas de cálculo, presentaciones, imágenes y PDF, incluido el camino de vuelta. No hay pantalla de conversión para el usuario final: se llama desde dentro de un proceso que ya está en marcha.
Endpoints, ejemplos de código, límites por plan y precios están en el sitio del producto: convertfilefast.com. Ahí es donde se vende. Aquí abajo va nuestra versión de la historia.
Y el punto era siempre el mismo: alguien abriendo un archivo solo para guardarlo en otro formato.
Esto apareció primero en nuestro propio trabajo de automatización, dentro de la operación de clientes. Armábamos un flujo que iba de principio a fin por sí solo, y se atascaba en un paso tonto: el sistema siguiente no lee el formato que generó el anterior. Cada episodio aislado es rápido; lo que pesa es la frecuencia con que vuelve, todos los días.
La primera salida que probamos fue la que prueba todo el mundo: instalar un paquete de oficina en el servidor y llamarlo por línea de comandos. Funciona un tiempo. Después llega la actualización que cambia el diseño, el proceso que se cuelga y deja un archivo bloqueado, el volumen del cierre de mes que hace caer la máquina. A partir de ahí, convertir archivos pasó a ser una infraestructura más que mantener en pie.
Y está el costo silencioso del error de conversión. Cuando se pierde la fuente o se rompe la tabla, el documento le llega mal al cliente. El retrabajo no es convertir de nuevo: es la llamada para explicar por qué el contrato salió con la cláusula fuera de lugar. Viendo eso, decidimos escribir el nuestro.
Todas redujeron el público posible. Fue intencional, y vale la pena explicar por qué.
La mayoría de los convertidores son sitios donde alguien arrastra el archivo y descarga el resultado. Eso no resolvía nuestro problema: si alguien tiene que arrastrar, alguien sigue siendo el paso manual. Así que no construimos esa pantalla para el usuario final. Hay endpoint, clave y llamada desde dentro del flujo. El costo es evidente: quien solo quiere convertir un archivo suelto no es nuestro caso, y preferimos decirlo antes que fingir que sirve.
El camino tradicional para la conversión es asíncrono: la API acepta, devuelve un identificador y tú consultas después. Es más fácil de escalar. Elegimos el modo síncrono porque el paso del formato suele estar en medio de un flujo, y un flujo que se queda consultando vuelve a tener un estado que gestionar, justo la complejidad que la automatización existía para eliminar. La mayoría de los archivos vuelve en menos de dos segundos; los más grandes o complejos tardan más.
Guardar el archivo convertido habría sido útil: nos habría dado caché y reprocesamiento. Decidimos no guardar el contenido: se procesa en memoria y se descarta cuando termina la conversión. Queda el registro de la llamada: nombre del archivo, tamaño, IP y navegador de origen, que es lo que alimenta el historial en el panel. Renunciamos al resto porque lo que se convierte ahí son documentos de clientes, y que no exista una copia acorta mucho la conversación con el área legal de quien contrata.
Un límite declarado vale más que un superlativo, sobre todo cuando probarlo cuesta una solicitud.
Más de sesenta tipos de conversión, conservando formato, fuentes, imágenes y diseño, que es la parte que decide si el documento va directo al cliente o necesita una revisión humana. Se pueden convertir varios archivos en una sola solicitud, lo que resuelve el lote que llega todo junto en el cierre de mes. El plan gratuito da diez conversiones por mes, con un límite de cinco megabytes por archivo, y no pide tarjeta.
Sigue sin haber una pantalla de conversión para el usuario final. El único lugar donde se arrastra un archivo es el probador de la documentación, que ya exige una clave. El tamaño máximo de archivo también está limitado según el plan.
El panel muestra las últimas conversiones y el uso de los últimos treinta días, pero lo que guarda es el registro de la llamada, no el archivo. No hay reprocesamiento de lo que ya se envió: si tu proceso necesita reabrir una conversión de hace tres meses, quien guarda el archivo eres tú.
Convert File Fast nació dentro de Sincron IA, el mismo equipo que hace automatización de procesos en la operación de sus clientes. Cuando el cuello de botella es más grande de lo que una herramienta puede resolver, el camino es la etapa de Discovery.
La documentación, los endpoints y el plan gratuito están en su sitio. Este texto fue solo para explicar por qué existe.
