java rest api on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/id/tag/java-rest-api/ Recent content in java rest api on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io id Wed, 23 Sep 2026 13:04:19 +0000 Tambahkan Teks Overlay ke GIF menggunakan REST di Java https://blog-qa.groupdocs.cloud/id/watermark/add-text-overlay-to-gif-using-rest-in-java/ Wed, 23 Sep 2026 13:04:19 +0000 https://blog-qa.groupdocs.cloud/id/watermark/add-text-overlay-to-gif-using-rest-in-java/ Pelajari cara menambahkan overlay teks ke GIF menggunakan GroupDocs.Watermark Cloud SDK for Java via REST API. Termasuk kode, cURL, dan langkah-langkah penyiapan sekarang. Mulai dengan cepat. Menambahkan caption dinamis, subtitle, atau pesan promosi ke GIF animasi adalah kebutuhan umum untuk aplikasi web dan seluler modern. GroupDocs.Watermark Cloud SDK for Java menyediakan pustaka berbasis REST yang kuat yang membuat tugas ini menjadi mudah. Dalam panduan ini Anda akan mempelajari cara menambahkan Overlay teks ke GIF menggunakan REST di Java, melihat implementasi Java lengkap, menjelajahi perintah cURL yang setara, dan memahami langkah‑langkah penyiapan yang diperlukan.

Menambahkan Teks Overlay ke GIF Menggunakan REST di Java - Contoh Kode

Contoh ini menunjukkan cara mengonfigurasi watermark teks dan menerapkannya ke setiap frame file GIF.

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();
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menambahkan Teks pada GIF dengan REST API Menggunakan cURL

Berikut adalah perintah cURL yang melakukan operasi yang sama dari terminal. Mereka menggambarkan alur kerja REST lengkap: otentikasi, unggah, penambahan watermark, dan unduhan.

# 1. Dapatkan token akses
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"}'

Ganti YOUR_ACCESS_TOKEN dalam panggilan berikut dengan token yang dikembalikan di atas.

# 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

Untuk detail lebih lanjut tentang badan permintaan dan format respons, lihat dokumentasi API resmi.

Memecah Penambahan Teks Overlay ke GIF Menggunakan REST di Java - Cara Kerjanya

  1. Inisialisasi klien API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") membuat objek konfigurasi yang menyimpan kredensial Anda. Instansi WatermarkApi menggunakan konfigurasi ini untuk menandatangani setiap permintaan.
Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

  1. Tentukan file sumber dan tujuan - FileInfo dan OutputFileInfo memberi tahu layanan di mana membaca GIF asli dan di mana menulis hasilnya. Keduanya dapat merujuk ke nama penyimpanan khusus.

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

  2. Konfigurasikan watermark teks - TextWatermarkOptions menyimpan semua properti visual: teks, font, ukuran, warna, opasitas, rotasi, dan perataan. Menetapkan pageRange ke "1-" memastikan setiap frame GIF animasi menerima overlay.

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-");

  1. Bangun dan kirim permintaan - AddWatermarkRequest menggabungkan info file dan opsi. Memanggil watermarkApi.addWatermark(request) melakukan operasi pada server dan mengembalikan jalur file yang diproses.

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

  2. Tangani respons - Respons berisi jalur file output. Dalam aplikasi nyata, Anda biasanya akan mengunduh file atau meneruskan jalur tersebut ke layanan lain.

Untuk daftar lengkap kelas dan properti, lihat referensi API.

Menginstal dan Mengonfigurasi GroupDocs.Watermark Cloud SDK for Java

Tambahkan dependensi Maven ke pom.xml Anda (atau entri Gradle yang setara). Ini menarik versi 23.8 dari SDK.

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

Prasyarat

  • Java 8 atau lebih tinggi
  • Akun GroupDocs Cloud yang aktif
  • Client ID and Client Secret (tersedia di dasbor GroupDocs Cloud)

Contoh Konfigurasi

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

Unduh JAR terbaru dari halaman unduhan. Untuk penggunaan produksi, terapkan lisensi yang valid yang diperoleh dari halaman lisensi sementara.

Kesimpulan

Menambahkan teks Overlay ke GIF menggunakan REST di Java menjadi operasi berulang di sisi server dengan bantuan GroupDocs.Watermark Cloud SDK for Java. SDK menyederhanakan kompleksitas penanganan frame animasi, memungkinkan Anda fokus pada konten subtitle atau pesan promosi Anda. Setelah mengintegrasikan kode contoh atau alur kerja cURL, Anda dapat menyesuaikan gaya font, warna, dan opasitas agar sesuai dengan merek Anda. Ingatlah untuk mengamankan lisensi produksi; detail harga tersedia di halaman produk, dan lisensi sementara dapat diperoleh untuk pengujian melalui halaman lisensi sementara. Selamat coding!

Pertanyaan yang Sering Diajukan

  • Bagaimana cara menambahkan overlay teks ke GIF menggunakan REST di Java ketika teks berubah untuk setiap pengguna?
    Bangun objek TextWatermarkOptions pada runtime dengan string spesifik pengguna, lalu panggil addWatermark yang sama. API memproses setiap permintaan secara independen, sehingga konten dinamis sepenuhnya didukung.

  • Bisakah saya menambahkan subtitle ke GIF animasi tanpa memengaruhi kecepatan animasinya?
    Ya. Watermark diterapkan pada setiap frame sambil mempertahankan jeda frame asli. Cukup setel pageRange ke "1-" sehingga setiap frame menerima overlay yang sama.

  • Format apa yang didukung untuk warna teks overlay?
    SDK menerima kode warna HEX (mis., #FF0000) dan nama warna standar HTML . Lihat referensi API untuk daftar lengkap.

  • Apakah saya memerlukan lisensi untuk pengembangan dan pengujian?
    Lisensi sementara sudah cukup untuk evaluasi dan pengujian. Untuk penyebaran produksi, beli lisensi penuh dari halaman produk dan terapkan menggunakan API lisensi SDK.

Baca Selengkapnya

]]> Proteksi Kata Sandi Excel melalui REST di Java https://blog-qa.groupdocs.cloud/id/merger/password-protect-excel-via-rest-in-java/ Fri, 04 Sep 2026 12:18:34 +0000 https://blog-qa.groupdocs.cloud/id/merger/password-protect-excel-via-rest-in-java/ Pelajari cara melindungi workbook Excel dengan password melalui REST di Java menggunakan GroupDocs.Merger Cloud SDK. Panduan langkah demi langkah, contoh kode, dan perintah cURL disertakan. Menutupi data sensitif dalam buku kerja Excel adalah kebutuhan umum bagi perusahaan yang berbagi laporan secara internal atau dengan mitra. GroupDocs.Merger Cloud SDK for Java memungkinkan pengembang menambahkan perlindungan kata sandi ke file XLSX melalui API REST sederhana. Dalam panduan ini Anda akan mempelajari cara mengimplementasikan password Protect Excel via REST in Java, melihat contoh Java lengkap, dan menjalankan perintah cURL setara untuk integrasi cloud.

Prasyarat dan Penyiapan

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

  • Java 8 atau lebih tinggi terpasang.
  • Maven atau Gradle untuk manajemen dependensi.
  • Akun GroupDocs Cloud dengan client ID dan client secret.
  • Akses ke penyimpanan cloud tempat file Excel akan berada.

Tambahkan dependensi Maven ke pom.xml Anda (atau potongan Gradle yang setara):

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

Anda dapat mengunduh JAR terbaru dari halaman unduhan. Setelah menambahkan dependensi, buat objek konfigurasi dengan kredensial Anda:

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

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

Dengan klien siap, Anda dapat melanjutkan ke alur kerja perlindungan kata sandi yang sebenarnya.

Melindungi Excel dengan Password melalui REST di Java: Panduan Langkah-demi-Langkah

Langkah 1: Muat Dokumen Sumber

Tentukan lokasi file XLSX sumber di dalam penyimpanan cloud Anda.

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

Langkah 2: Atur Jalur Tujuan

Tentukan di mana workbook yang dilindungi akan disimpan.

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

Langkah 3: Konfigurasikan Opsi Perlindungan Kata Sandi

Buat objek ProtectOptions, lampirkan info file, jalur output, dan kata sandi yang diinginkan.

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

Langkah 4: Bangun Permintaan Lindungi Dokumen

Bungkus opsi dalam ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Langkah 5: Eksekusi Permintaan dan Tangani Respons

Panggil metode API dan proses setiap kesalahan.

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());
}

Untuk detail lebih lanjut tentang setiap kelas, lihat referensi API.

Contoh Lengkap yang Berfungsi untuk Melindungi Excel dengan Kata Sandi via REST di Java

Kode berikut menunjukkan proses lengkap dari awal hingga akhir.

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());
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.xlsx, output_protected.xlsx) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Lindungi Excel Workbook melalui REST API menggunakan cURL

Berikut adalah sekumpulan perintah cURL yang melakukan operasi perlindungan kata sandi yang sama secara langsung terhadap endpoint REST.

1. Autentikasi dan dapatkan token akses

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"
         }'

Respons berisi access_token yang akan Anda gunakan dalam panggilan berikutnya.

2. Unggah file XLSX sumber

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. Permintaan perlindungan kata sandi

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. Unduh workbook yang dilindungi

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

Perintah ini memungkinkan Anda mengintegrasikan alur kerja perlindungan ke dalam skrip atau pipeline CI. Untuk detail lebih lanjut, lihat dokumentasi API resmi.

Kesimpulan

Implementasi Password Protect Excel via REST di Java sangat mudah dengan GroupDocs.Merger Cloud SDK for Java. Dengan mengikuti langkah‑langkah di atas, Anda dapat mengamankan workbook Excel, mengotomatisasi proses dalam aplikasi sisi‑server, dan menjaga data sensitif tetap aman. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; informasi harga tersedia di halaman produk dan Anda dapat memulai dengan lisensi sementara untuk mengevaluasi pustaka ini. Selamat coding!

FAQs

  • Bagaimana perlindungan Excel dengan kata sandi melalui REST di Java berbeda dari enkripsi lokal?
    API cloud melakukan enkripsi di server, sehingga Anda tidak perlu mengelola perpustakaan kriptografi secara lokal. SDK menangani konstruksi permintaan dan parsing respons, menyederhanakan integrasi.

  • Apakah memungkinkan untuk mengatur opsi perlindungan tambahan, seperti mode baca‑saja?
    Kelas ProtectOptions saat ini berfokus pada perlindungan dengan kata sandi. Untuk fitur keamanan yang lebih canggih, konsultasikan referensi API untuk parameter yang lebih baru.

  • Format file apa yang didukung untuk perlindungan kata sandi?
    Merger API saat ini mendukung XLSX, DOCX, PPTX, dan PDF untuk enkripsi. Lihat dokumentasi resmi untuk daftar lengkap.

  • Apakah saya memerlukan lisensi untuk menjalankan contoh di lingkungan pengembangan?
    Pengembangan dan pengujian dapat dilakukan dengan lisensi sementara. Penyebaran produksi memerlukan lisensi berbayar, yang dapat Anda beli melalui halaman produk.

Baca Selengkapnya

]]>