Conversión

La API de Metadatos es un servicio diseñado específicamente para desarrolladores que pone el control total sobre los metadatos de los archivos de hoja de cálculo al alcance de tu mano con una sola solicitud HTTP. Ya sea que trabajes con formatos de oficina clásicos como Excel (.xlsx, .xls), archivos delimitados simples como CSV (.csv) y TSV (.tsv), o incluso documentos de Apple Numbers (.numbers), la API abstrae la complejidad del análisis de archivos y te permite leer, añadir o modificar propiedades descriptivas clave en cuestión de milisegundos. Imagina poder procesar por lotes miles de informes, conjuntos de datos de investigación o estados financieros, enriqueciendo cada archivo con un conjunto coherente de información del autor, títulos, asuntos, descripciones, listas de palabras clave e incluso colecciones de etiquetas personalizadas que define tu propia aplicación. Este nivel de automatización no solo ahorra innumerables horas de edición manual, sino que también garantiza que cada archivo que entregues a clientes, colaboradores o sistemas de archivo lleve exactamente los metadatos necesarios para la indexación, el cumplimiento y la descubribilidad. El servicio funciona aceptando ya sea los bytes crudos del archivo o una URL que apunte a un documento alojado en la nube, y devuelve un archivo nuevo, completamente formado, con los cambios de metadatos solicitados aplicados sin alterar el diseño original de los datos ni las fórmulas.

Características principales

Dado que la API es sin estado, puedes integrarla fácilmente en canalizaciones CI/CD, trabajos por lotes del lado del servidor o widgets JavaScript del lado del cliente, garantizando que cada exportación de una aplicación web o cada copia de seguridad periódica contenga la información de procedencia correcta. La seguridad está incorporada: todas las llamadas se realizan sobre TLS, la carga útil está encriptada de extremo a extremo, y la API soporta autenticación mediante clave API o OAuth 2.0, lo que te permite limitar el acceso solo a servicios de confianza. El motor subyacente aprovecha bibliotecas de análisis altamente optimizadas para cada formato compatible, garantizando que incluso libros de Excel masivos con cientos de hojas se procesen rápidamente; la mayoría de las solicitudes típicas se completan en menos de 200 ms. En la práctica, esto significa que puedes crear un botón “Añadir Metadatos” dentro de tu producto que envíe el archivo al servicio, reciba la versión enriquecida y la ofrezca para descarga inmediata, todo sin que el usuario abandone la interfaz. La API también devuelve registros de operación detallados, de modo que los desarrolladores pueden verificar programáticamente que los campos esperados fueron actualizados, revertir cambios si es necesario o activar pasos de procesamiento adicionales basados en valores de etiquetas personalizadas. Al proporcionar un punto final REST uniforme y agnóstico al lenguaje, la API de Metadatos elimina la necesidad de que los desarrolladores mantengan múltiples bibliotecas específicas de formato, reduce la sobrecarga de mantenimiento y asegura compatibilidad a prueba de futuro a medida que emergen nuevos estándares de hojas de cálculo. Ya seas un proveedor SaaS que busca incrustar información de licencia, una institución de investigación que catalogiza conjuntos de datos o una empresa que automatiza el cumplimiento documental, esta API ofrece una forma rápida, segura y escalable de enriquecer tus archivos con una sola llamada sencilla.

Documentos

Parámetros

AppRequest.Metadata: Con PropertyName y PropertyValue
AppRequest.MetadataJson: Si no estás usando la estructura Metadata, entonces debes usar el tipo de dato JSON.
UploadFileRequest.OperationId: Estos son archivos que necesitas subir a nuestros servicios en línea; puedes preparar los datos a tu manera, pero deben seguir el estándar del input file HTML.
UploadFileRequest.Files: Estos son archivos que necesitas subir a nuestros servicios en línea; puedes preparar los datos a tu manera, pero deben seguir el estándar del input file HTML.

Usar el endpoint

Envía una solicitud que incluya los archivos y el token de acceso API de Metadatos

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.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ía 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ás el archivo y podrás usarlo o simplemente enviarlo al siguiente paso de tu flujo de trabajo.