Comparación

Bienvenido al centro oficial de documentación de la API de Comparación, una solución diseñada para transformar la a menudo tediosa tarea de control de versiones de hojas de cálculo en un flujo de trabajo simplificado y centrado en el desarrollador. Ya sea que sea un analista de datos conciliando informes trimestrales, un equipo financiero rastreando revisiones de presupuestos, o un ingeniero de software incorporando capacidades de diff en una tubería de datos más grande, esta API está diseñada para adaptarse a sus necesidades y eliminar la conjetura al detectar cambios en una amplia variedad de formatos de hoja de cálculo. En su núcleo, la API de Comparación sigue un modelo simple pero potente: usted proporciona dos archivos de origen —ya provengan de Apple Numbers, una exportación CSV/TSV, o la omnipresente suite Excel (.xlsx, .xls)— y el servicio devuelve un único archivo de resultado que resalta cada adición, eliminación y modificación con indicadores visuales nítidos. El énfasis en la claridad no es una reflexión posterior; cada diferencia está anotada de manera que refleja las convenciones nativas de las hojas de cálculo (fondos de celda codificados por colores, burbujas de comentarios y marcadores de fila/columna) para que los usuarios finales puedan abrir el resultado en su aplicación preferida y comprender instantáneamente qué ha cambiado. Más allá del diff básico, la API también conserva el formato original, fórmulas y tipos de datos, garantizando que la salida no sea solo un informe de texto plano, sino un libro de trabajo totalmente funcional listo para un análisis adicional o distribución. La seguridad y el rendimiento están integrados en cada solicitud: todas las transferencias de archivos ocurren sobre TLS 1.3, los archivos se procesan en contenedores aislados con límites estrictos de memoria, y los resultados se devuelven típicamente en menos de un segundo para archivos de hasta 10 MB, escalando de forma elegante para conjuntos de datos más grandes mediante streaming por fragmentos. La documentación que está leyendo ahora está organizada para que pueda ponerse en marcha en minutos —comenzando con la autenticación, pasando por la construcción de la solicitud, y culminando en patrones de mejores prácticas para manejo de errores, paginación e integración de webhooks. A lo largo encontrará fragmentos de código en Python, JavaScript, Java y C#, que ilustran cómo una sola línea de código puede desencadenar una comparación completa, así como un entorno sandbox donde puede experimentar con archivos reales sin salir del navegador. Al final de esta guía, tendrá una comprensión robusta de cómo incrustar una comparación de hojas de cálculo fiable y de alta fidelidad en cualquier flujo de trabajo, reducir el tiempo de revisión manual y capacitar a los interesados con registros de cambios transparentes y auditables —todo mientras aprovecha una API tan segura y rápida como fácil de usar.

Características Principales

La API de Comparación cuenta con un conjunto amplio de funcionalidades que abordan los puntos de dolor más comunes al conciliar datos de hojas de cálculo en plataformas diversas. En primer lugar, la API soporta una lista completa de formatos de archivo: Apple Numbers (.numbers), archivos de texto delimitados (CSV, TSV), Excel heredado (.xls) y Excel moderno (.xlsx). Esto elimina la necesidad de herramientas de pre‑conversión, permitiéndole alimentar los archivos originales directamente al servicio. El motor de diff opera a nivel de celda, detectando cambios en valores, fórmulas e incluso atributos de formato como estilo de fuente, sombreado de celdas y reglas de validación de datos; cada variación se destaca claramente en el libro de trabajo resultante mediante esquemas de color personalizables, facilitando la interpretación por parte de revisores no técnicos. Para conjuntos de datos de gran escala, la API ofrece modo de comparación incremental, permitiendo comparar solo las filas que se han añadido o modificado desde una línea base previa, reduciendo así el tiempo de procesamiento y el ancho de banda de la red. Además, puede solicitar un resumen estructurado en JSON de los cambios además del archivo de diff visual, habilitando automatizaciones posteriores como desencadenar alertas, actualizar paneles de control o alimentar los cambios a sistemas de control de versiones. Las características de seguridad incluyen autenticación OAuth 2.0 mediante token Bearer, claves API con alcance, y whitelist de IP opcional, mientras que los datos en reposo se cifran con AES‑256. El servicio también cumple con los estándares de conformidad GDPR y CCPA, dándole confianza al manejar información personal o financiera sensible. En cuanto al rendimiento, la API está diseñada para baja latencia; gracias al escalado horizontal y algoritmos de diff en memoria, la mayoría de comparaciones se completan en menos de un segundo para libros de trabajo de tamaño estándar, con soporte para procesamiento asíncrono mediante webhooks para archivos que superen los 50 MB. Finalmente, la experiencia del desarrollador es una prioridad máxima: especificaciones completas OpenAPI, SDKs autogenerados, códigos de error detallados y encabezados de límite de velocidad en tiempo real le permiten integrar la API con mínima fricción, mientras que nuestra consola sandbox y extenso repositorio de ejemplos muestran implementaciones de mejores prácticas para procesamiento por lotes, pipelines CI/CD y funciones serverless. En resumen, la API de Comparación ofrece capacidades de diff de hojas de cálculo rápidas, seguras y amigables para el desarrollador que le permiten detectar cambios con una única llamada sencilla, sin importar el formato, tamaño o complejidad de los datos que esté manejando.

Documentos

Parámetros

format: Un formato de archivo de salida compatible.
UploadFileRequest.OperationId: Este es un ID de operación
UploadFileRequest.Files: Estos son archivos que debe cargar a nuestros servicios en línea; puede preparar los datos a su manera, pero deben seguir el estándar del campo de entrada HTML.

Utilizar el Endpoint

Envíe una solicitud que incluya los archivos y el token de acceso API de Comparación

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
El servicio responderá con una URL de descarga para el archivo procesado, en este ejemplo es:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Envíe una solicitud que incluya el nombre del archivo y el nombre de la carpeta a API de Descarga

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Recibirá el archivo y podrá usarlo o simplemente pasarlo al siguiente paso de su flujo de trabajo.