[go: up one dir, main page]

Skip to content

A PHP component library for integrating with ComPDFKit API to build a PDF Viewer and Editor.

Notifications You must be signed in to change notification settings

ComPDFKit/compdfkit-api-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ComPDFKit API in PHP

Introduction

ComPDFKit offers powerful and steady PDF libraries and complete PDF functions to build PDF viewer and editor, which allows to preview, edit, annotate, sign, encrypt and decrypt PDF files.

ComPDFKit API provides a variety of PHP API tools that allow you to create an efficient document processing workflow in a single API call.

ComPDFKit API allows you to get 1000 files processing monthly now! Just sign up for a free trial and enjoy comprehensive PDF functions.

Related

Requirements

Programming Environment: PHP Version 7.0 and higher.

Dependencies: Composer.

Installation

You can install the library via Composer. Run the following command.

composer require compdfkit/compdfkit-api-php

Alternatively, you can add "compdfkit/compdfkit-api-php": "^1.2.4" to your "composer.json" file and then run it.

composer update

If you are not using a PHP framework with autoload feature, you need to use the code below to autoload.

require_once('vendor/autoload.php');

Usage

Create An API Client

First of all, please create an API client to complete the authentication. You need to sign in your ComPDFKit API account to get your publicKey and secretKey at the dashboard. If you are new to ComPDFKit, click here to sign up for a free trial to process 1,000 documents per month for free.

  • Project public Key: You can find the public key in the API Keys section of your ComPDFKit API account.

  • Project secret Key: You can find the secret Key in the API Keys section of your ComPDFKit API account.

$client = new CPDFClient('public_key', 'secret_key');

Create A Task

A task ID is automatically generated for you based on the type of PDF tool you choose. You can provide the callback notification URL. After the task processing is completed, we will notify you of the task result through the callback interface. You can perform other operations according to the request result, such as checking the status of the task, uploading files, starting the task, or downloading the result file.

// Create a client
$client = new CPDFClient('public_key', 'secret_key');

// Create a task
// Create an example of a PDF TO WORD task
$taskInfo = $client->createTask(CPDFConversion::PDF_TO_WORD);

Upload Files

Upload the original file and bind the file to the task ID. The field parameter is used to pass the JSON string to set the processing parameters for the file. Each file will generate automatically a unique filekey. Please note that a maximum of five files can be uploaded for a task ID and no files can be uploaded for that task after it has started.

// Create a client
$client = new CPDFClient('public_key', 'secret_key');

// Create a task
// Create an example of a PDF TO WORD task
$taskInfo = $client->createTask(CPDFConversion::PDF_TO_WORD);

// Upload files
$file = $client->addFile('test.pdf')->uploadFile($taskInfo['taskId']);

Execute the Task

After the file upload is completed, call this interface with the task ID to process the files.

// Create a client
$client = new CPDFClient('public_key', 'secret_key');

// Create a task
// Create an example of a PDF TO WORD task
$taskInfo = $client->createTask(CPDFConversion::PDF_TO_WORD);

// Upload files
$file = $client->addFile('test.pdf')->uploadFile($taskInfo['taskId']);

// execute Task
$client->executeTask($taskInfo['taskId']);

Get The Task Info

Request task status and file-related meta data based on the task ID.

// Create a client
$client = new CPDFClient('public_key', 'secret_key');

// Create a task
// Create an example of a PDF TO WORD task
$taskInfo = $client->createTask(CPDFConversion::PDF_TO_WORD);

// Upload files
$file = $client->addFile('test.pdf')->uploadFile($taskInfo['taskId']);

// Execute Task
$client->executeTask($taskInfo['taskId']);

// Query TaskInfo
$taskInfo = $client->getTaskInfo($taskInfo['taskId']);

Examples

There are many examples in the samples folder, which show the main features of the ComPDFKit API and how to use them, such as watermarking PDFs, converting PDF to Word, Excel, JPG, PNG, etc. You can copy the code to your project and run it directly. To learn more about the ComPDFKit API, please visit our API Reference.

Free Trial

ComPDFKit API is a powerful API that can be used to create an efficient document processing workflow in a single API call.

If you do not have a ComPDFKit API account, you can sign up for a free trial to process 1,000 documents per month for free.

Once you have a ComPDFKit API account, you can obtain your publicKey and secretKey in the dashboard.

Support

ComPDFKit has a professional R&D team that produces comprehensive technical documentation and guides to help developers. Also, you can get an immediate response when reporting your problems to our support team.

For detailed information, please visit our Guides page.

Stay updated with the latest improvements through our Changelog.

For technical assistance, please reach out to our Technical Support.

To get more details and an accurate quote, please contact our Sales Team.

License