
פקודות cURL הן דרך מצוינת להעברת נתונים עם כתובות URL. מומלץ להשתמש בפקודות cURL כדי להשתמש בממשקי API ממסופי שורת הפקודה. זה לא רק מאפשר לנו להגיש בקשות קבועות, אלא גם לפרסם נתוני טפסים, לאמת משתמשים, לשמור תגובות לקבצים ופעולות אחרות של מניפולציה של קבצים קשורות. במילים פשוטות, curl הוא כלי שורת פקודה להעברת נתונים משרת או אל שרת שנועד לעבוד ללא אינטראקציה של המשתמש. עם curl, אתה יכול להוריד או להעלות נתונים באמצעות אחד מהפרוטוקולים הנתמכים כולל HTTP, HTTPS, SCP, SFTP ו-FTP.
עם זאת, זה גם מקל עלינו לבדוק ממשקי API של RESTfull.
נעשה שימוש בפקודות cURL
לְקַבֵּל
הבקשה/פעולה הפשוטה והנפוצה ביותר שנעשתה באמצעות HTTP היא קבלת כתובת URL. בעת שימוש בפקודה זו, אנו שולחים בקשה ומחזירים משאבים מכתובת URL ספציפית (מסמך במקרה שלנו).
שֶׁלְאַחַר
בקשת ברירת המחדל היא GET אך אם יש לנו דרישה להשתמש באותה פקודת cURL לשליחת נתוני טפסים, עלינו להשתמש בבקשת POST. לכן במאמר זה, נשתמש באותה פקודת POST כדי לשלוח תוכן טקסט. שים לב שכדי לפרסם נתונים, אנו משתמשים בפרמטר -d (או – data) עם הפקודה cURL.
לָשִׂים
אנו עשויים להיתקל בדרישה לעדכן נתונים קיימים, ולכן לשם כך, נעשה שימוש בשיטת PUT. על מנת למלא את הדרישה הזו, עלינו להשתמש ב-X PUT בפקודה cURL כאשר X צריך להיות באותיות רישיות.
למידע נוסף, בקר בcURL Tutorial.
הערה: בעת שימוש בפקודות cURL, ודא שאינך מכניס רווח נוסף לאחר הקו הנטוי \ else, הפקודה לא תבוצע ושגיאות יוצגו.
הגדרת cURL ב-Mac
במאמר זה, אנו הולכים להשתמש בפקודות cURL ב-macOS כדי להוסיף ולעדכן אובייקטים של כותרת תחתונה בתוך מסמך MS Word באמצעות יישום מסוף. אז כדי להתחיל, הדבר הראשון הוא להתקין cURL ב-macOS. פתח את אפליקציית המסוף תחת קטגוריית אחרים מלוח ההפעלה או, הקש Command+רווח והקלד Terminal והקש על מקש Enter/Return. הדרך הקלה ביותר להתקין cURL היא באמצעות Homebrew ומסיבה זו, ראשית, עליך להגדיר homebrew במחשב ה-Mac שלך. הקלד את הפקודה הבאה במסוף שורת הפקודה והקש על מקש Enter.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
כעת קבל את חבילת הבישול עבור cURL באמצעות הפקודה הבאה.
brew install curl
נַעֲשָׂה! עכשיו אתה יכול להשתמש בתלתל.
אישור חשבון Aspose.Cloud
על מנת להתחיל עם Aspose.Cloud APIs, הצעד הראשון הוא לאמת את החשבון שלך ולקבל JWT בתגובה. אם אין לך חשבון, אתה יכול ליצור אחד ב-Aspose.Cloud dashboard או להירשם דרך חשבון Google או GitHub הקיים שלך ולהתחיל להשתמש בממשקי ה-API שלנו בענן.
// 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.Words Cloud
Aspose מציעה ממשקי API לתמרן מסמכי MS Word ואתה מקבל אפשרות להשתמש ב-Cloud APIs, On-Premise APIs או, Cross-platform Apps לעיבוד מסמכי Word. בבלוג זה, הדגשנו על ממשקי API של ענן המספקים לנו את היכולות ליצור, לתפעל ולשנות מסמכי MS Word בענן. לא נדרשת הורדה או התקנה ספציפית של תוכנה כדי לעבוד עם קבצי MS Word.
משפחת Aspose.Cloud Product מספקת קבוצה של ערכות פיתוח ענן המתמקדות בשפות תכנות פופולריות כולל .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift ו-Go. כל ה-SDKs הללו הם מעטפת סביב Aspose.Words Cloud REST API ופקודות cURL הן אחת הדרכים הפשוטות והקלות ביותר לגשת לממשקי REST API דרך שורת הפקודה/טרמינל.
בבלוג זה, אנו שמים דגש על שימוש בפקודות cURL כדי לתפעל את קטע הכותרת העליונה והתחתונה בתוך קבצי MS Word תוך גישה ל-Aspose.Words Cloud API.
העלה מסמך וורד
לאחר ביצוע האימות, השלב הבא הוא העלאת הקובץ לאחסון בענן. על ידי שימוש בפקודה cURL הבאה, הקובץ מועלה לאחסון ברירת המחדל תחת 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

הודעת הצלחה כאשר קובץ מועלה לאחסון בענן.
כעת על מנת לאשר את נוכחות הקבצים באחסון בענן, פתח את הכרטיסייה ‘הקבצים שלי’ מעל dashboard.aspose.cloud, אנו יכולים לשים לב שתיקיה חדשה בשם InputFolder המכילה BusinessLetter2.docx מופיעה ברשימה.

הוסף אובייקט כותרת
לאחר העלאת המסמך, נוכל להכניס אובייקט Header או Footer חדש או לגשת לאובייקט קיים ולעדכן את המאפיינים שלו. נכון לעכשיו, Aspose.Words Cloud API תומך בסוגים הבאים של אובייקטי Header ו-Footer.

הפקודה הבאה מראה כיצד להוסיף אובייקט HeaderFirst בתוך מסמך Word שכבר זמין באחסון בענן תחת 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"
לאחר ביצוע הפקודה לעיל, המסוף מפרט את הקטעים בתוך מסמך Word.

קטעי הכותרת העליונה והתחתונה מכילים בדרך כלל טקסט, תמונות וכו’, ובפקודה הבאה, אנו הולכים להכניס טקסט לדוגמה בתוך הפסקה הראשונה בתוך אובייקט הכותרת שנוצר לעיל.
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"


עדכן את עיצוב הטקסט של אובייקט הכותרת
לאחר הוספת הטקסט, נוכל לעדכן את מאפייני גופן הטקסט. מכיוון שמסמך Word עשוי להכיל מופעי טקסט רבים, לכן על מנת לעדכן את הטקסט, עלינו לספק את הנתיב המדויק. אז אם אנחנו צריכים לעדכן את מאפייני הגופן עבור הטקסט שהוכנס לעיל שמוכנס מעל sections/0/headersfooters/1/paragraphs/0/runs/0, אז עלינו להשתמש בפקודה הבאה.
שימו לב שעכשיו, כשאנחנו הולכים לעדכן את מאפייני הגופן של אובייקטים שכבר הוצבו, אז אנחנו צריכים להשתמש בפקודה 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"

הוסף מספר עמוד בכותרת התחתונה
אחד השימושים החשובים באובייקטי Header ו-Footer הוא להציג מידע על מספרי עמודים ובזמן השימוש ב-Aspose.Words Cloud, נוכל לעמוד בדרישה זו בקלות. ה-API מספק גם את היכולות לציין את המיקום שבו יש להציג את חותמת ה-PageNumber. כפי שמוצג בפקודה למטה, ציינו להוסיף מידע על מספר עמודים שיוצג במיקום הימני העליון של הדף וגם להציג אותו על העמוד הראשון של המסמך.
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"

בדומה לעדכון מאפייני גופן למופע Header, אנו יכולים גם לעדכן את מאפייני הגופן של אובייקט Footer המכיל מידע PageNumber. מכיוון שמידע מספר העמוד מורכב מאובייקטים של שלוש ריצות (runs/0, runs/2 ו-runs/3), לכן עלינו לעדכן את פקודת עדכון הפונט שלוש פעמים עבור כל מופע ריצה.
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"

לאחר ביצוע כל הפקודות לעיל, המסמך שנוצר ייראה דומה לתצוגה המקדימה שלמעלה.
לעיונך, מצורפים גם המסמכים לדוגמה: