java rest api on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/tr/tag/java-rest-api/ Recent content in java rest api on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io tr Wed, 23 Sep 2026 13:04:19 +0000 REST kullanarak Java'da GIF'e Metin Katmanı Ekle https://blog-qa.groupdocs.cloud/tr/watermark/add-text-overlay-to-gif-using-rest-in-java/ Wed, 23 Sep 2026 13:04:19 +0000 https://blog-qa.groupdocs.cloud/tr/watermark/add-text-overlay-to-gif-using-rest-in-java/ GroupDocs.Watermark Cloud SDK for Java via REST API kullanarak GIF'lere metin bindirme eklemeyi öğrenin. Kod, cURL ve kurulum adımlarını içerir. Hemen başlayın. Animasyonlu GIF’lere dinamik altyazılar, alt yazılar veya tanıtım mesajları eklemek, modern web ve mobil uygulamalar için yaygın bir ihtiyaçtır. GroupDocs.Watermark Cloud SDK for Java bu görevi basitleştiren güçlü bir REST‑tabanlı kütüphane sağlar. Bu rehberde Java’da REST kullanarak GIF üzerine metin katmanı eklemeyi öğrenecek, tam bir Java uygulamasını görecek, eşdeğer cURL komutlarını inceleyecek ve gerekli kurulum adımlarını anlayacaksınız.

REST Kullanarak Java’da GIF’e Metin Bindirme - Örnek Kod

Bu örnek, bir metin filigranını nasıl yapılandıracağınızı ve bir GIF dosyasının her karesine nasıl uygulayacağınızı gösterir.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile GIF Üzerine Metin Yerleştirme

Aşağıda, bir terminalden aynı işlemi gerçekleştiren cURL komutları bulunmaktadır. Bu komutlar tam REST iş akışını gösterir: kimlik doğrulama, yükleme, filigran ekleme ve indirme.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Aşağıdaki çağrılarda YOUR_ACCESS_TOKEN ifadesini yukarıda döndürülen token ile değiştirin.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

İstek gövdeleri ve yanıt formatları hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

REST Kullanarak Java’da GIF’e Metin Katmanı Ekleme - Nasıl Çalışır

  1. API istemcisini başlatın - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") kimlik bilgilerinizi tutan bir yapılandırma nesnesi oluşturur. WatermarkApi örneği bu yapılandırmayı her isteği imzalamak için kullanır.
Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

  1. Kaynak ve hedef dosyaları belirtin - FileInfo ve OutputFileInfo hizmete orijinal GIF’i nereden okuyacağını ve sonucu nereye yazacağını söyler. Her ikisi de özel bir depolama adı referans alabilir.

    FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.gif");
inputFile.setStorageName("MyStorage");

  2. Metin filigranını yapılandırın - TextWatermarkOptions tüm görsel özellikleri tutar: metin, yazı tipi, boyut, renk, saydamlık, döndürme ve hizalama. pageRange değerini "1-" olarak ayarlamak, animasyonlu GIF’in her karesinin üst katmanı almasını sağlar.

    TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");

  3. İsteği oluşturun ve gönderin - AddWatermarkRequest dosya bilgilerini ve seçenekleri bir araya getirir. watermarkApi.addWatermark(request) çağrısı, işlemi sunucuda gerçekleştirir ve işlenmiş dosyanın yolunu döndürür.

    AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);

  4. Yanıtı İşleyin - Yanıt, çıktı dosyasının yolunu içerir. Gerçek bir uygulamada genellikle dosyayı indirir veya yolu başka bir hizmete geçirirsiniz.

Sınıfların ve özelliklerin tam listesi için, API referansına bakın.

Kurulum ve Yapılandırma GroupDocs.Watermark Cloud SDK for Java

Maven bağımlılığını pom.xml dosyanıza ekleyin (veya eşdeğer Gradle girdisini). Bu, SDK’nın 23.8 sürümünü getirir.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Önkoşullar

  • Java 8 ve üzeri
  • Aktif bir GroupDocs Cloud hesabı
  • Client ID ve Client Secret (GroupDocs Cloud kontrol panelinde mevcut)

Yapılandırma Örneği

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

En son JAR’ları indirme sayfası üzerinden indirin. Üretim kullanımı için, geçerli bir lisansı geçici lisans sayfası üzerinden alın.

Sonuç

REST kullanarak Java’da GIF’e metin bindirme eklemek, GroupDocs.Watermark Cloud SDK for Java sayesinde tekrarlanabilir bir sunucu‑tarafı işleme dönüşür. SDK, animasyonlu karelerin işlenmesindeki karmaşıklıkları soyutlayarak altyazılarınızın veya tanıtım mesajlarınızın içeriğine odaklanmanızı sağlar. Örnek kodu veya cURL iş akışını entegre ettikten sonra, marka kimliğinize uygun olacak şekilde yazı tiplerini, renkleri ve opaklığı ince ayar yapabilirsiniz. Ürün sayfasında üretim lisansı fiyatlandırma detayları mevcuttur ve test amaçlı geçici bir lisans geçici lisans sayfası üzerinden alınabilir. İyi kodlamalar!

SSS

  • Kullanıcıya göre değişen metinle Java’da REST kullanarak GIF’e metin Katmanı nasıl eklenir?
    Kullanıcıya özgü dizeyi runtime’da TextWatermarkOptions nesnesiyle oluşturun, ardından aynı addWatermark çağrısını yapın. API her isteği bağımsız olarak işler, bu yüzden dinamik içerik tam olarak desteklenir.

  • Animasyon hızını etkilemeden bir animasyonlu GIF’e altyazı ekleyebilir miyim?
    Evet. Filigran, orijinal kare gecikmesini korurken her kareye uygulanır. Sadece pageRange değerini "1-" olarak ayarlayın, böylece her kare aynı kaplamayı alır.

  • Overlay metin rengi için hangi formatlar destekleniyor?
    SDK, HEX renk kodlarını (ör. #FF0000) ve standart HTML renk adlarını kabul eder. Tam liste için API referansına bakın.

  • Geliştirme ve test için bir lisansa ihtiyacım var mı?
    Değerlendirme ve test için geçici bir lisans yeterlidir. Üretim dağıtımları için, ürün sayfasından tam bir lisans satın alın ve SDK’nın lisanslama API’si ile uygulayın.

Daha Fazla

]]> REST ile Java’da Excel’e Şifre Koruması https://blog-qa.groupdocs.cloud/tr/merger/password-protect-excel-via-rest-in-java/ Fri, 04 Sep 2026 12:18:34 +0000 https://blog-qa.groupdocs.cloud/tr/merger/password-protect-excel-via-rest-in-java/ Java&#39;da REST aracılığıyla bir Excel çalışma kitabını şifreyle korumayı, GroupDocs.Merger Cloud SDK kullanarak öğrenin. Adım adım kılavuz, kod örneği ve cURL komutları dahil. Excel çalışma kitaplarında hassas verileri gizlemek, raporları dahili olarak veya ortaklarla paylaşan işletmeler için yaygın bir gereksinimdir. GroupDocs.Merger Cloud SDK for Java geliştiricilerin XLSX dosyalarına basit bir REST API aracılığıyla şifre koruması eklemesini sağlar. Bu rehberde REST üzerinden Java ile Excel Şifreleme nasıl uygulanacağını öğrenecek, tam bir Java örneğini görecek ve bulut entegrasyonu için eşdeğer cURL komutlarını çalıştıracaksınız.

Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Java 8 veya üzeri yüklü.
  • Bağımlılık yönetimi için Maven veya Gradle.
  • client ID ve client secret içeren bir GroupDocs Cloud hesabı.
  • Excel dosyalarının bulunacağı bulut depolamaya erişim.

Maven bağımlılığını pom.xml dosyanıza ekleyin (veya eşdeğer Gradle snippet’ı):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

En son JAR’ları indirme sayfasından indirebilirsiniz. Bağımlılığı ekledikten sonra, kimlik bilgilerinizle bir yapılandırma nesnesi oluşturun:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

İstemci hazır olduğunda, gerçek parola korumalı iş akışına geçebilirsiniz.

Java’da REST ile Excel Şifreleme: Adım Adım Rehber

Adım 1: Kaynak Belgeyi Yükle

Bulut depolamanızdaki kaynak XLSX dosyasının konumunu belirleyin.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Adım 2: Hedef Yolu Ayarlayın

Korunan çalışma kitabının nereye kaydedileceğini belirtin.

String outputPath = "output_protected.xlsx"; // destination file

Adım 3: Şifre Koruma Seçeneklerini Yapılandır

Bir ProtectOptions nesnesi oluşturun, dosya bilgilerini, çıktı yolunu ve istenen şifreyi ekleyin.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Adım 4: Koruma Belgesi İsteğini Oluştur

Seçenekleri bir ProtectDocumentRequest içinde sarın.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Adım 5: İsteği Yürütme ve Yanıtı İşleme

API yöntemini çağırın ve oluşabilecek hataları işleyin.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Her sınıf hakkında daha fazla ayrıntı için, API referansı adresine bakın.

REST üzerinden Java’da Excel Şifre Koruması için Tam Çalışan Örnek

Aşağıdaki kod, baştan sona kadar tam süreci gösterir.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (input.xlsx, output_protected.xlsx) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile Excel Çalışma Kitabını Koru

Aşağıda, aynı parola‑koruma işlemini doğrudan REST uç noktalarına karşı gerçekleştiren bir dizi cURL komutu bulunmaktadır.

1. Kimlik doğrulama yapın ve bir erişim belirteci alın

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.

2. Kaynak XLSX dosyasını yükleyin

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Parola koruması isteği

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Korunan çalışma kitabını indirin

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Bu komutlar, koruma iş akışını betiklere veya CI boru hatlarına entegre etmenizi sağlar. Daha fazla ayrıntı için, resmi API belgelerine bakın.

Sonuç

Java’da REST üzerinden Java ile Excel Şifreleme uygulaması, GroupDocs.Merger Cloud SDK for Java ile oldukça basittir. Yukarıdaki adımları izleyerek Excel çalışma kitaplarını güvence altına alabilir, sunucu‑tarafı uygulamalarda süreci otomatikleştirebilir ve hassas verileri güvende tutabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma bilgileri ürün sayfasında mevcuttur ve kütüphaneyi değerlendirmek için bir geçici lisans ile başlayabilirsiniz. İyi kodlamalar!

FAQs

  • Java’da REST üzerinden Excel şifreleme, yerel şifrelemeden nasıl farklıdır?
    Bulut API’si şifrelemeyi sunucuda gerçekleştirir, bu sayede kriptografik kütüphaneleri yerel olarak yönetmeniz gerekmez. SDK, istek oluşturma ve yanıt ayrıştırmayı yönetir, entegrasyonu basitleştirir.

  • Ek koruma seçenekleri, örneğin yalnızca‑okunur mod gibi, ayarlanabilir mi?
    Mevcut ProtectOptions sınıfı şifre korumasına odaklanmaktadır. Daha gelişmiş güvenlik özellikleri için, yeni parametreler hakkında API referansı adresine bakın.

  • Şifre koruması için hangi dosya formatları destekleniyor?
    Merger API şu anda şifreleme için XLSX, DOCX, PPTX, ve PDF formatlarını desteklemektedir. Tam liste için resmi belgeler bölümüne bakın.

  • Geliştirme ortamında örneği çalıştırmak için bir lisansa ihtiyacım var mı?
    Geliştirme ve test işlemleri geçici bir lisansla yapılabilir. Üretim dağıtımları ise ürün sayfası üzerinden satın alabileceğiniz ücretli bir lisans gerektirir.

Daha Fazla Oku

]]>