A cURL parancsok kiváló módja az adatok URL-ekkel történő átvitelének. A cURL parancsok ajánlottak a parancssori terminálokból származó API-k használatához. Nemcsak rendszeres kéréseket tesz lehetővé, hanem űrlapadatokat is feladhatunk, felhasználókat hitelesíthetünk, válaszokat fájlokra menthetünk és egyéb kapcsolódó fájlkezelési műveleteket is végezhetünk. Egyszerűen fogalmazva, a curl egy parancssori segédprogram az adatok kiszolgálóról vagy szerverre történő átvitelére, amelyet úgy terveztek, hogy felhasználói beavatkozás nélkül működjön. A curl segítségével adatokat tölthet le vagy tölthet fel a támogatott protokollok egyikével, beleértve a HTTP, HTTPS, SCP, SFTP és FTP protokollokat.

Mindazonáltal megkönnyíti számunkra a RESTfull API-k tesztelését.

cURL parancsokat használt

KAP

A HTTP használatával végzett legegyszerűbb és leggyakoribb kérés/művelet az URL BESZERZÉSE. A parancs használatakor kérést küldünk és erőforrásokat kérünk le egy adott URL-ről (esetünkben egy dokumentumról).

POST

Az alapértelmezett kérés egy GET, de ha ugyanazt a cURL parancsot kell használnunk az űrlapadatok elküldéséhez, akkor POST kérést kell használnunk. Ezért ebben a cikkben ugyanazt a POST parancsot fogjuk használni szöveges tartalom elküldésére. Kérjük, vegye figyelembe, hogy az adatok közzétételéhez a -d (vagy – data) paramétert használjuk a cURL paranccsal.

PUT

Előfordulhat, hogy a meglévő adatok frissítésére vonatkozó követelménybe ütközünk, ezért erre a célra PUT módszert alkalmazunk. Ennek a követelménynek a teljesítéséhez a -X PUT parancsot kell használnunk a cURL parancsban, ahol az X-nek nagybetűnek kell lennie.

További információért látogasson el a cURL oktatóprogram oldalára.

Megjegyzés: cURL parancsok használatakor ügyeljen arra, hogy ne tegyen extra szóközt a fordított perjel után \ különben a parancs nem kerül végrehajtásra, és hibák jelennek meg.

A cURL beállítása Macen

Ebben a cikkben cURL-parancsokat fogunk használni a macOS rendszeren a Header Footer objektumok beszúrására és frissítésére az MS Word dokumentumba egy terminálalkalmazás segítségével. Tehát az induláshoz először telepítse a cURL-t macOS-re. Nyissa meg a Terminal alkalmazást az Egyéb kategória alatt az indítópulton, vagy nyomja meg a Command+Space billentyűkombinációt, írja be a Terminal parancsot, majd nyomja meg az Enter/Return billentyűt. A cURL telepítésének legegyszerűbb módja a Homebrew használata, ezért először is be kell állítania a homebrew-t a Mac gépen. Írja be a következő parancsot a parancssori terminálba, és nyomja meg az Enter billentyűt.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null

Most szerezze be a cURL brew csomagját a következő paranccsal.

 brew install curl

Kész! Most már használhatja a göndörítést.

Engedélyezze az Aspose.Cloud-fiókot

Az Aspose.Cloud API-k használatának megkezdéséhez az első lépés a fiók hitelesítése, és a JWT válasza. Ha nincs fiókja, létrehozhat egyet az Aspose.Cloud dashboard oldalon, vagy regisztrálhat meglévő Google- vagy GitHub-fiókján keresztül, és elkezdheti használni Cloud API-jainkat.

// 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"

Aspose.Szófelhő

Az Aspose API-kat kínál az MS Word dokumentumok kezeléséhez, és lehetősége van Cloud API-k, On-Premise API-k vagy cross-platform Apps használatára a Word dokumentumok feldolgozásához. Ebben a blogban hangsúlyt fektettünk a felhő API-kra, amelyek lehetővé teszik számunkra MS Word dokumentumok létrehozását, kezelését és átalakítását a felhőben. Az MS Word fájlok használatához nincs szükség speciális szoftver letöltésére vagy telepítésére.

Az Aspose.Cloud termékcsalád felhőalapú SDK-k készletét kínálja, amelyek a népszerű programozási nyelveket célozzák meg, például .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, G és Swift. Mindezek az SDK-k az Aspose.Words Cloud REST API körét foglalják magukban, és a cURL parancsok az egyik legegyszerűbb és legegyszerűbb módja a REST API-k parancssoron/terminálon keresztüli elérésének.

Ebben a blogban hangsúlyozzuk, hogy a cURL parancsokat használjuk az MS Word fájlok fejléc és lábléc szakaszának manipulálására az [Aspose.Words Cloud API18 elérése közben.

Word dokumentum feltöltése

A hitelesítés végrehajtása után a következő lépés a fájl feltöltése a felhőtárhelyre. A következő cURL paranccsal a fájl feltöltődik az InputFolder alatti alapértelmezett tárhelyre.

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
A konzol kimenete, amikor a fájlt feltöltik a Cloud Storage szolgáltatásba

Sikerüzenet, amikor egy fájlt feltöltenek a felhőtárhelyre.

Most, hogy megbizonyosodjon a fájlok felhőtárhelyen való jelenlétéről, nyissa meg a Saját fájlok lapot a dashboard.aspose.cloud felett, és észrevehetjük, hogy egy új InputFolder nevű mappa jelenik meg a listában, amely tartalmazza a BusinessLetter2.docx fájlt.

Az újonnan létrehozott mappa és fájl feltöltve a Cloud Storage szolgáltatásba

Fejléc objektum beszúrása

A dokumentum feltöltése után vagy beszúrhatunk egy új fejléc vagy lábléc objektumot, vagy elérhetünk egy meglévő objektumot és frissíthetjük annak tulajdonságait. Jelenleg az Aspose.Words Cloud API a következő típusú fejléc- és láblécobjektumokat támogatja.

A következő parancs bemutatja, hogyan lehet beilleszteni a HeaderFirst objektumot a felhőalapú tárolásban az InputFolder alatt már elérhető Word dokumentumba.

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"

A fenti parancs végrehajtása után a konzol listázza a Word dokumentum szakaszait.

A fejléc és a lábléc részek általában szöveget, képeket stb. tartalmaznak, és a következő parancsban egy minta szöveget fogunk beszúrni a fent létrehozott fejléc objektum első bekezdésébe.

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"
felirat

Console output after Text is inserted in the Header object. Observe the path of the text inserted.

Frissítse a fejléc objektum szövegformázását

A szöveg beszúrása után frissíthetjük a szöveg betűtípus tulajdonságait. Mivel egy Word dokumentum sok szövegpéldányt tartalmazhat, ezért a szöveg frissítéséhez meg kell adnunk a pontos elérési utat. Tehát ha frissítenünk kell a fent beillesztett szöveg betűtípus-tulajdonságait, amely a sections/0/headersfooters/1/paragraphs/0/runs/0 fölé került, akkor a következő parancsot kell használnunk.

Kérjük, vegye figyelembe, hogy most, hogy egy már elhelyezett objektum font tulajdonságait frissítjük, ezért a PUT parancsot kell használnunk.

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"

Helyezze be az oldalszámot a láblécbe

A Header és Footer objektumok egyik fontos felhasználási módja az oldalszám információk megjelenítése, és az Aspose.Words Cloud használata közben ezt a követelményt könnyen teljesíthetjük. Az API lehetőséget biztosít arra is, hogy meghatározza azt a helyet, ahol az oldalszám bélyegzőjét meg kell jeleníteni. Ahogy az alábbi parancsban látható, megadtuk, hogy az oldalszám-információkat az oldal jobb felső részén jelenítse meg, és a dokumentum első oldalán is jelenítse meg.

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"

Hasonlóan a Fejléc-példány betűtípus-tulajdonságainak frissítéséhez, az Oldalszám-információkat tartalmazó Footer objektum betűtípus-tulajdonságait is frissíthetjük. Mivel az oldalszám információ három futtatású objektumból áll (runs/0, runs/2 és runs/3), ezért minden egyes futtatási példányhoz háromszor kell frissítenünk a font update parancsot.

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"

Az összes fenti parancs végrehajtása után az eredményül kapott dokumentum a fenti előnézethez hasonlóan fog kinézni.

Tájékoztatásul mellékeljük a mintadokumentumokat is: