Hasilkan Kode QR untuk Menandatangani PDF menggunakan REST API di PHP.

QR Code (Quick Response code) adalah jenis barcode Matrix yang dapat dibaca mesin dalam bentuk array kotak hitam dan putih. Ini adalah label optik yang berisi informasi yang dapat dibaca menggunakan pembaca QR. Kami dapat menghasilkan kode QR secara terprogram dan menandatangani dokumen dan gambar di cloud. Pada artikel ini, kita akan mempelajari cara membuat kode QR untuk menandatangani dokumen PDF menggunakan REST API di PHP.

Topik-topik berikut akan dibahas dalam artikel ini:

QR Code Generator REST API dan PHP SDK

Untuk menghasilkan kode QR untuk menandatangani dokumen PDF, kami akan menggunakan PHP SDK of GroupDocs.Signature Cloud API. Ini memungkinkan pembuatan, verifikasi, dan pencarian berbagai jenis tanda tangan seperti tanda tangan gambar, barcode, QR-Code, berbasis teks, digital, dan stempel. Ini mendukung jenis kode QR berikut:

  • Kode Aztek
  • Kode DataMatrix
  • GS1 DataMatrix
  • GS1 QR
  • QR

Silakan instal menggunakan perintah berikut di konsol:

composer require groupdocscloud/groupdocs-signature-cloud

Setelah instalasi, silakan gunakan autoload Komposer untuk menggunakan SDK seperti yang ditunjukkan di bawah ini:

require_once('vendor/autoload.php');

Harap dapatkan ID dan Rahasia Klien Anda dari dasbor sebelum mengikuti langkah-langkah yang disebutkan. Setelah Anda memiliki ID dan rahasia Anda, tambahkan kode seperti yang ditunjukkan di bawah ini:

// Contoh kode ini menunjukkan cara menambahkan ID klien dan rahasia Anda ke dalam kode.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';

static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// Menginisialisasi konfigurasi
$configuration = new GroupDocs\Signature\Configuration();

// Mengatur konfigurasi
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);

Hasilkan Kode QR untuk Menandatangani PDF menggunakan REST API di PHP

Kami dapat membuat kode QR untuk menandatangani dokumen PDF di cloud dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:

Unggah Dokumen

Pertama, kami akan mengunggah dokumen PDF ke cloud menggunakan contoh kode yang diberikan di bawah ini:

// Contoh kode ini menunjukkan cara mengunggah file PDF ke cloud.
// Inisialisasi api
$apiInstance = new GroupDocs\Signature\FileApi($configuration);

// Jalur file masukan
$file = "C:\\Files\\Signature\\sample.pdf";

// Unggah permintaan file
$request = new GroupDocs\Signature\Model\Requests\UploadFileRequest("sample.pdf", $file, self::$MyStorage, null);

// Unggah data
$response = $apiInstance->uploadFile($request);

Hasilnya, file PDF yang diunggah akan tersedia di files section dasbor di cloud.

Hasilkan Kode QR untuk Menandatangani PDF dalam PHP

Kami dapat membuat kode QR secara terprogram dan menandatangani dokumen PDF yang diunggah dengan mengikuti langkah-langkah berikut:

  1. Pertama, buat instance SignApi.
  2. Selanjutnya, berikan input jalur file PDF.
  3. Kemudian, atur jalur file keluaran.
  4. Selanjutnya, inisialisasi objek SignQRCodeOptions.
  5. Kemudian, atur QRCodeType ke “QR”. Apalagi mengatur teks, dan posisinya.
  6. Secara opsional, setel opsi seperti Page, RotationAngle, HorizontalAlignment, Border, Padding, dll.
  7. Setelah itu, buat createSignaturesRequest dengan SignSettings yang ditentukan.
  8. Terakhir, dapatkan hasil dengan memanggil metode createSignatures().

Contoh kode berikut menunjukkan cara membuat kode QR dan menandatangani dokumen PDF menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara membuat kode QR untuk Menandatangani dokumen PDF.
// Contoh SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);

// Jalur file masukan
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// Tentukan Pengaturan Tanda
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);

// Tentukan SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);

// Tentukan opsi Masuk kode QR
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);        
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);        
$options->setQRCodeType("QR");
$options->setText("This is sample QR.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);

// Warna
$color = new GroupDocs\Signature\Model\Warna();
$color->setWeb("Black");

// Berbatasan
$border = new GroupDocs\Signature\Model\BerbatasanLine();
$border->setWarna($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setBerbatasan($border);

// Lapisan
$padding = new GroupDocs\Signature\Model\Lapisan();
$padding->setAll(5);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);

$settings->setOptions([$options]);

// Buat permintaan tanda tangan
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);

// Buat tanda tangan
$response = $apiInstance->createSignatures($request);

echo "Response: ", $response->getFileInfo();
Hasilkan Kode QR untuk Menandatangani PDF menggunakan REST API di PHP.

Hasilkan Kode QR untuk Menandatangani PDF menggunakan REST API di PHP.

Unduh PDF yang Ditandatangani dengan Kode QR

Contoh kode di atas akan menyimpan file PDF yang ditandatangani di cloud. Itu dapat diunduh menggunakan contoh kode berikut:

// Contoh kode ini menunjukkan cara mengunduh file PDF dari cloud.
// Inisialisasi api
$apiInstance = new GroupDocs\Signature\FileApi($configuration);

// Unduh permintaan file
$request = new GroupDocs\Signature\Model\Requests\DownloadFileRequest("Aztec_QR_out.pdf", self::$MyStorage, null);

// Unduh berkas
$response = $apiInstance->downloadFile($request);

Hasilkan Kode Aztec untuk Menandatangani PDF dalam PHP

Kode Aztec adalah kode QR dua dimensi (2D) yang paling mudah dicetak dan mudah dipindai. Kami dapat membuat kode Aztec untuk menandatangani dokumen PDF yang diunggah dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kita hanya perlu menyetel QRCodeType ke “Aztec”.

Contoh kode berikut menunjukkan cara membuat kode Aztec dan menandatangani dokumen PDF menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara membuat kode Aztec di PHP.
// Contoh SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);

// Jalur file masukan
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// Tentukan Pengaturan Tanda
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);

// Tentukan SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);

// Tentukan opsi Masuk kode QR
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);        
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);        
$options->setQRCodeType("Aztec");
$options->setText("This is a sample Aztec QR code.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);

// Warna
$color = new GroupDocs\Signature\Model\Warna();
$color->setWeb("Black");

// Berbatasan
$border = new GroupDocs\Signature\Model\BerbatasanLine();
$border->setWarna($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setBerbatasan($border);

// Lapisan
$padding = new GroupDocs\Signature\Model\Lapisan();
$padding->setAll(2);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);

$settings->setOptions([$options]);

// Buat permintaan tanda tangan
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);

// Buat tanda tangan
$response = $apiInstance->createSignatures($request);

echo "Response: ", $response->getFileInfo();
Hasilkan Kode QR Aztec untuk Menandatangani PDF dalam PHP.

Hasilkan Kode Aztec untuk Menandatangani PDF dalam PHP.

Buat Kode DataMatrix untuk Menandatangani PDF di PHP

Kami juga dapat menghasilkan kode DataMatrix dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kita hanya perlu menyetel QRCodeType ke “DataMatrix”.

Contoh kode berikut menunjukkan cara membuat kode DataMatrix dan menandatangani dokumen PDF menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara menghasilkan kode DataMatrix di PHP.
// Contoh SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);

// Jalur file masukan
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// Tentukan Pengaturan Tanda
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);

// Tentukan SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);

// Tentukan opsi Tanda tangani kode QR
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);        
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);        
$options->setQRCodeType("DataMatrix");
$options->setText("This is a sample DataMatrix QR code.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);

// Warna
$color = new GroupDocs\Signature\Model\Warna();
$color->setWeb("Black");

// Berbatasan
$border = new GroupDocs\Signature\Model\BerbatasanLine();
$border->setWarna($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setBerbatasan($border);

// Lapisan
$padding = new GroupDocs\Signature\Model\Lapisan();
$padding->setAll(2);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);

$settings->setOptions([$options]);

// Buat permintaan tanda tangan
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);

// Buat tanda tangan
$response = $apiInstance->createSignatures($request);

echo "Response: ", $response->getFileInfo();
Buat Kode QR DataMatrix untuk Menandatangani PDF di PHP.

Buat Kode DataMatrix untuk Menandatangani PDF di PHP.

Verifikasi Tanda Tangan Kode QR di PHP

Anda dapat dengan mudah memverifikasi tanda tangan kode QR yang dihasilkan dengan mengikuti langkah-langkah berikut:

  1. Pertama, buat instance SignApi.
  2. Tetapkan jalur file PDF.
  3. Tentukan VerifikasiQRCodeOptions.
  4. Berikan Jenis Tanda Tangan, Teks, dan Kode.
  5. Tentukan VerifySettings dan tetapkan VerifyQRCodeOptions ke VerifySettings.
  6. Setelah itu, buat VerifySignatureRequest dengan VerifySettings.
  7. Terakhir, dapatkan hasil dengan memanggil metode verifySignatures().

Contoh kode berikut menunjukkan cara memverifikasi tanda tangan kode QR menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara memverifikasi tanda tangan kode QR.
// Contoh SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);

// Jalur file masukan
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("QR_out.pdf");

// Tentukan pengaturan verifikasi
$settings = new GroupDocs\Signature\Model\VerifySettings();
$settings->setFileInfo($fileInfo);

// Tentukan verifikasi opsi kode QR
$options = new GroupDocs\Signature\Model\VerifyQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);        
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);        
$options->setQRCodeType("QR");
$options->setText("This is sample QR.");

$settings->setOptions([$options]);

// Verifikasi permintaan tanda tangan
$request = new GroupDocs\Signature\Model\Requests\VerifySignaturesRequest($settings);

// Verifikasi tanda tangan
$response = $apiInstance->verifySignatures($request);

echo "Response: ", $response;

Coba Daring

Silakan coba alat tanda tangan PDF online gratis berikut, yang dikembangkan menggunakan API di atas. https://products.groupdocs.app/signature/pdf

Kesimpulan

Dalam artikel ini, kita telah mempelajari cara:

  • menghasilkan kode QR dalam PHP;
  • menandatangani dokumen PDF dengan kode QR dalam PHP;
  • verifikasi tanda tangan elektronik di PHP;
  • mengunggah file PDF ke cloud secara terprogram;
  • unduh file PDF yang ditandatangani dari cloud.

Selain itu, Anda dapat mempelajari lebih lanjut tentang GroupDocs.Signature Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.

Lihat juga