Los comandos cURL son una excelente manera de transferir datos con URL. Se recomiendan los comandos cURL para usar API desde terminales de línea de comandos. No solo nos permite realizar solicitudes regulares, sino que también podemos publicar datos de formularios, autenticar usuarios, guardar respuestas a archivos y otras operaciones relacionadas con la manipulación de archivos. En palabras simples, curl es una utilidad de línea de comandos para transferir datos desde o hacia un servidor diseñada para funcionar sin interacción del usuario. Con curl, puede descargar o cargar datos utilizando uno de los protocolos compatibles, incluidos HTTP, HTTPS, SCP, SFTP y FTP.
Sin embargo, también nos facilita probar APIs RESTfull.
Comandos cURL utilizados
CONSEGUIR
La solicitud/operación más simple y más común que se realiza mediante HTTP es obtener una URL. Al utilizar este comando, enviamos una solicitud y recuperamos recursos de una URL específica (un documento en nuestro caso).
CORREO
La solicitud predeterminada es GET, pero si necesitamos usar el mismo comando cURL para enviar datos de formularios, debemos usar la solicitud POST. Por lo tanto, en este artículo, usaremos el mismo comando POST para enviar contenido de texto. Tenga en cuenta que para enviar datos, usamos el parámetro -d (o – data) con el comando cURL.
PONER
Es posible que nos encontremos con un requisito para actualizar datos existentes, por lo que para ello se utiliza un método PUT. Para cumplir con este requisito, debemos utilizar -X PUT en el comando cURL, donde X debe estar en mayúsculas.
Para obtener más información, visite tutorial de cURL.
Nota: al utilizar comandos cURL, asegúrese de no colocar un espacio adicional después de la barra invertida; de lo contrario, el comando no se ejecutará y se mostrarán errores.
Configuración de cURL en Mac
En este artículo, vamos a utilizar comandos cURL en macOS para insertar y actualizar objetos de encabezado y pie de página dentro de un documento de MS Word mediante una aplicación de terminal. Para comenzar, lo primero que hay que hacer es instalar cURL en macOS. Abra la aplicación Terminal en la categoría Otros desde el panel de inicio o presione Comando+Espacio y escriba Terminal y presione la tecla Intro/Retorno. La forma más sencilla de instalar cURL es utilizando Homebrew y, por ese motivo, primero debe configurar Homebrew en su máquina Mac. Escriba el siguiente comando en la terminal de línea de comandos y presione la tecla Intro.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
Ahora obtenga el paquete brew para cURL usando el siguiente comando.
brew install curl
¡Listo! Ahora puedes usar curl.
Autorizar cuenta Aspose.Cloud
Para comenzar a utilizar las API de Aspose.Cloud, el primer paso es autenticar su cuenta y obtener JWT como respuesta. Si no tiene una cuenta, puede crear una en el panel de control de Aspose.Cloud o registrarse a través de su cuenta existente de Google o GitHub y comenzar a utilizar nuestras API de Cloud.
// First get JSON Web Token for authentication
// Get App Key and App SID from https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Cloud de palabras de Aspose
Aspose ofrece API para manipular documentos de MS Word y tiene la opción de usar API en la nube, API locales o Aplicaciones multiplataforma para procesar documentos de Word. En este blog, hemos hecho hincapié en las API en la nube que nos brindan las capacidades para crear, manipular y transformar documentos de MS Word en la nube. No se requiere la descarga o instalación de ningún software específico para trabajar con archivos de MS Word.
La familia de productos Aspose.Cloud ofrece un conjunto de SDK en la nube destinados a lenguajes de programación populares, entre los que se incluyen .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift y Go. Todos estos SDK son un envoltorio de Aspose.Words Cloud REST API y los comandos cURL son una de las formas más sencillas y fáciles de acceder a las API REST a través del símbolo del sistema o la terminal.
En este blog, hacemos hincapié en el uso de comandos cURL para manipular la sección de encabezado y pie de página dentro de archivos MS Word al acceder a Aspose.Words Cloud API.
Subir documento Word
Una vez realizada la autenticación, el siguiente paso es cargar el archivo al almacenamiento en la nube. Mediante el siguiente comando cURL, el archivo se carga al almacenamiento predeterminado en InputFolder.
curl -v -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/InputFolder" \
-H "accept: application/json" \
-H "authorization: Bearer <jwt token>" \
-F document=@BusinessLetter2.docx
Mensaje de éxito cuando se carga un archivo al almacenamiento en la nube.
Ahora, para confirmar la presencia del archivo en el almacenamiento en la nube, abra la pestaña Mis archivos en dashboard.aspose.cloud, podemos notar que aparece una nueva carpeta llamada InputFolder que contiene BusinessLetter2.docx en la lista.
Insertar objeto de encabezado
Después de cargar el documento, podemos insertar un nuevo objeto de encabezado o pie de página o acceder a un objeto existente y actualizar sus propiedades. Actualmente, Aspose.Words Cloud API admite los siguientes tipos de objetos de encabezado y pie de página.
El siguiente comando muestra cómo insertar el objeto HeaderFirst dentro de un documento de Word ya disponible en el almacenamiento en la nube bajo InputFolder.
curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/headersfooters?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "'HeaderFirst'" \
-H "Content-Type: application/json"
Una vez que se ejecuta el comando anterior, la consola enumera las secciones dentro del documento de Word.
Las secciones de encabezado y pie de página generalmente contienen texto, imágenes, etc. y en el siguiente comando vamos a insertar un texto de muestra dentro del primer párrafo dentro del objeto de encabezado creado anteriormente.
curl -v -X POST "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Text': 'Aspose.Words Cloud .NET SDK' }" \
-H "Content-Type: application/json"
Actualizar el formato del texto del objeto de encabezado
Una vez que se inserta el texto, podemos actualizar las propiedades de la fuente del texto. Dado que un documento de Word puede contener muchas instancias de texto, para actualizar el texto, debemos proporcionar la ruta exacta. Por lo tanto, si necesitamos actualizar las propiedades de la fuente para el texto insertado anteriormente que se inserta en secciones/0/encabezados/pies/1/párrafos/0/ejecuciones/0, entonces debemos usar el siguiente comando.
Tenga en cuenta que ahora vamos a actualizar las propiedades de fuente de un objeto ya colocado, por lo que debemos usar el comando PUT.
curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs/0/runs/0/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Calibri', 'Color': { 'Web': '#f54269', 'Alpha': 0 } }" \
-H "Content-Type: application/json"
Insertar número de página en el pie de página
Uno de los usos importantes de los objetos de encabezado y pie de página es mostrar información sobre el número de página y, al utilizar Aspose.Words Cloud, podemos cumplir fácilmente con este requisito. La API también proporciona la capacidad de especificar la ubicación en la que se debe mostrar el sello PageNumber. Como se muestra en el comando a continuación, hemos especificado que se agregue la información PageNumber para que se represente en la ubicación superior derecha de la página y también se muestre en la primera página del documento.
curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/PageNumbers?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Format': '{PAGE} of {NUMPAGES}', 'Alignment': 'right', 'IsTop': false, 'SetPageNumberOnFirstPage': true }" \
-H "Content-Type: application/json"
De manera similar a la actualización de las propiedades de fuente de la instancia de encabezado, también podemos actualizar las propiedades de fuente del objeto de pie de página que contiene información de PageNumber. Como la información de número de página se compone de objetos de tres ejecuciones (ejecuciones/0, ejecuciones/2 y ejecuciones/3), debemos actualizar el comando de actualización de fuente tres veces para cada instancia de ejecución.
curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/3/paragraphs/1/runs/3/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Arial', 'Shadow': true, 'Color': { 'Web': '#f5b642', 'Alpha': 0 } }" \
-H "Content-Type: application/json"
Una vez ejecutados todos los comandos anteriores, el documento resultante tendrá un aspecto similar a la vista previa anterior.
Para su referencia, también se adjuntan los documentos de muestra: