cURL komutları, URL’lerle veri aktarmanın mükemmel bir yoludur. cURL komutları, komut satırı terminallerinden API’leri kullanmak için önerilir. Sadece düzenli istekler yapmamızı sağlamakla kalmaz, aynı zamanda form verilerini gönderebilir, kullanıcıları doğrulayabilir, yanıtları dosyalara kaydedebilir ve diğer ilgili dosya işleme işlemlerini yapabiliriz. Basitçe ifade etmek gerekirse, curl, kullanıcı etkileşimi olmadan çalışmak üzere tasarlanmış bir sunucudan veya sunucuya veri aktarmak için bir komut satırı yardımcı programıdır. curl ile HTTP, HTTPS, SCP, SFTP ve FTP dahil olmak üzere desteklenen protokollerden birini kullanarak veri indirebilir veya yükleyebilirsiniz.

Bununla birlikte, RESTfull API’leri test etmemizi de kolaylaştırıyor.

kullanılan cURL komutları

ELDE ETMEK

HTTP kullanılarak yapılan en basit ve en yaygın istek/işlem bir URL’yi GET’lemektir. Bu komutu kullanırken, belirli bir URL’den (bizim durumumuzda bir belge) bir istek gönderir ve kaynakları alırız.

POSTALAMAK

Varsayılan istek bir GET’tir ancak form verilerini göndermek için aynı cURL komutunu kullanma gereksinimimiz varsa, POST isteğini kullanmamız gerekir. Bu nedenle bu makalede, metin içeriğini göndermek için aynı POST komutunu kullanacağız. Lütfen veri göndermek için cURL komutuyla -d (veya – data) parametresini kullandığımızı unutmayın.

KOYMAK

Mevcut verileri güncelleme gereksinimiyle karşılaşabiliriz, bu amaçla bir PUT yöntemi kullanılır. Bu gereksinimi yerine getirmek için, X’in büyük harf olması gereken cURL komutunda -X PUT kullanmamız gerekir.

Daha fazla bilgi için lütfen cURL eğitimi adresini ziyaret edin.

Not: cURL komutlarını kullanırken ters eğik çizgiden sonra fazladan bir boşluk bırakmamaya dikkat edin. Aksi takdirde komut yürütülmeyecek ve hatalar gösterilecektir.

Mac’te cURL kurulumu

Bu makalede, bir terminal uygulaması kullanarak MS Word belgesine Üstbilgi Altbilgi nesnelerini eklemek ve güncellemek için macOS’ta cURL komutlarını kullanacağız. Bu nedenle, başlamak için ilk yapmanız gereken macOS’ta cURL’yi yüklemektir. Başlatma panelinden Diğerleri kategorisi altında Terminal uygulamasını açın veya Command+Space tuşlarına basın ve Terminal yazın ve enter/return tuşuna basın. cURL’yi yüklemenin en kolay yolu Homebrew kullanmaktır ve bu nedenle, öncelikle mac makinenizde homebrew’u kurmanız gerekir. Komut satırı terminalinde aşağıdaki komutu yazın ve Enter tuşuna basın.

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

Şimdi aşağıdaki komutu kullanarak cURL için brew paketini alın.

 brew install curl

Tamamdır! Artık curl’ü kullanabilirsiniz.

Aspose.Cloud hesabını yetkilendirin

Aspose.Cloud API’leri ile başlamak için ilk adım hesabınızı doğrulamak ve yanıt olarak JWT almaktır. Hesabınız yoksa Aspose.Cloud panosunda bir hesap oluşturabilir veya mevcut Google veya GitHub hesabınız üzerinden kaydolabilir ve Cloud API’lerimizi kullanmaya başlayabilirsiniz.

// 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.Kelime Cloudu

Aspose, MS Word belgelerini işlemek için API’ler sunar ve Word belgelerini işlemek için Cloud API’leri, Yerinde API’ler veya Platformlar Arası Uygulamalar kullanma seçeneğiniz olur. Bu blogda, bize Cloudta MS Word belgeleri oluşturma, işleme ve dönüştürme yetenekleri sağlayan Cloud API’lerini vurguladık. MS Word dosyalarıyla çalışmak için belirli bir yazılım indirme veya kurulum gerekmez.

Aspose.Cloud Ürün ailesi, .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift ve Go dahil olmak üzere popüler programlama dillerini hedefleyen bir dizi bulut SDK’sı sağlar. Tüm bu SDK’lar Aspose.Words Cloud REST API etrafında bir sarmalayıcıdır ve cURL komutları, komut istemi/terminal üzerinden REST API’lerine erişmenin en basit ve en kolay yollarından biridir.

Bu blogda, Aspose.Words Cloud API‘ye erişirken MS Word dosyaları içindeki Başlık ve Altbilgi bölümlerini yönetmek için cURL komutlarının kullanılması üzerinde duruyoruz.

Word belgesini yükle

Kimlik doğrulaması gerçekleştirildikten sonraki adım dosyayı bulut depolama alanına yüklemektir. Aşağıdaki cURL komutunu kullanarak dosya, InputFolder altındaki varsayılan depolama alanına yüklenir.

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
Dosya Cloud Depolamaya yüklendiğinde konsol çıktısı

Bir dosya bulut depolama alanına yüklendiğinde başarı mesajı.

Şimdi bulut depolama alanındaki dosyanın varlığını doğrulamak için dashboard.aspose.cloud üzerindeki Dosyalarım sekmesini açın, listede BusinessLetter2.docx içeren InputFolder adlı yeni bir klasörün göründüğünü görebiliriz.

Yeni Oluşturulan klasör ve dosya Cloud Depolamaya yüklendi

Başlık nesnesi ekle

Belgeyi yükledikten sonra, yeni bir Başlık veya Altbilgi nesnesi ekleyebilir veya mevcut bir nesneye erişip özelliklerini güncelleyebiliriz. Şu anda, Aspose.Words Cloud API aşağıdaki Başlık ve Altbilgi nesnesi türlerini destekler.

Aşağıdaki komut, Cloud depolamada InputFolder altında halihazırda mevcut olan Word belgesine HeaderFirst nesnesinin nasıl ekleneceğini gösterir.

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"

Yukarıdaki komut çalıştırıldığında konsol Word belgesinin içindeki bölümleri listeler.

Başlık ve Altbilgi bölümleri genellikle metin, resim vb. içerir ve aşağıdaki komutta, yukarıda oluşturulan başlık nesnesinin içindeki ilk paragrafın içine örnek bir metin ekleyeceğiz.

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"

Başlık nesnesinin Metin Biçimlendirmesini Güncelle

Metin eklendikten sonra, metin yazı tipi özelliklerini güncelleyebiliriz. Bir Word belgesi birçok metin örneği içerebileceğinden, metni güncellemek için tam yolu sağlamamız gerekir. Dolayısıyla, yukarıda eklenen ve sections/0/headersfooters/1/paragraphs/0/runs/0 üzerine eklenen metin için yazı tipi özelliklerini güncellememiz gerekirse, aşağıdaki komutu kullanmamız gerekir.

Şimdi yerleştirilmiş bir nesnenin font özelliklerini güncelleyeceğimiz için PUT komutunu kullanmamız gerektiğini belirtelim.

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"

Sayfa Numarasını Alt Bilgiye Ekle

Header ve Footer nesnelerinin önemli kullanımlarından biri sayfa numarası bilgilerini görüntülemektir ve Aspose.Words Cloud kullanırken bu gereksinimi kolayca gerçekleştirebiliriz. API ayrıca PageNumber damgasının görüntülenmesi gereken konumu belirtme yeteneklerini de sağlar. Aşağıdaki komutta gösterildiği gibi, sayfanın Sağ Üst konumuna PageNumber bilgisinin eklenmesini ve ayrıca belgenin ilk sayfasında görüntülenmesini belirttik.

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 örneğine font özelliklerinin güncellenmesine benzer şekilde, PageNumber bilgisi içeren Footer nesnesinin font özelliklerini de güncelleyebiliriz. Sayfa numarası bilgisi üç çalıştırma nesnesinden (runs/0, runs/2 ve runs/3) oluştuğu için, font güncelleme komutunu her çalıştırma örneği için üç kez güncellememiz gerekir.

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"

Yukarıdaki tüm komutlar yürütüldüğünde, ortaya çıkan belge yukarıdaki önizlemeye benzer görünecektir.

Bilginiz olması açısından örnek dokümanlar da ektedir: