Download the PHP package qaamgo/onlineconvert-api-sdk without Composer

Online Convert API version 2 PHP SDK v 3

This SDK provides a code base to interact with the API version 2 of Online-Convert.com

Installation

The recommended way to install is through Composer.

Getting started

Configuration

Sending a full job

Sending a job with a gdrive_picker input

What is google drive picker

Google drive picker allows you to access files stored in your google drive account.

You can find information about it in the official page

Meaning of each field:

• type
  • Specifies that we want to use the google drive picker input
• source
  • This must contain the FILE ID given back by the google drive picker
• credentials
  • This must be an array containing the credentials for the selected file
  • At the moment you only need to pass the "token" field inside it
  • The "token" field is returned by the google drive picker when a file is selected
• content_type
  • This field is mandatory when you select a Google Document
  • You can leave this field empty if you are selecting any other kind of file
  • EG: pdf, png, zip...
• filename
  • This is the file name of the google drive picker file
  • If this field is not sent the file will be downloaded with the name output.<extension>

After this just follow the previous examples on how to effectively send the job to the API.

Sending a job using Cloud storage providers

The following is an example to send a job where we want to convert a file that we have stored in our Amazon S3 storage.

If you want to know more please check our cloud storage API documentation

After this just follow the previous examples on how to effectively send the job to the API.

Downloading the Converted Files

You can download the converted files using the following code snippet:

Advanced usage

The class \OnlineConvert\Api::class has some shortcut methods that links it to the endpoints classes (EG: \OnlineConvert\Api::postFullJob()), but from the class you can call the real endpoint and their methods.

Also, you can create endpoint classes one by one if you like. For this, check \OnlineConvert\Endpoint\Abstracted::_construct()

IMPORTANT: The class \OnlineConvert\Endpoint\JobsEndpoint can be used to send both synchronous and asynchronuos jobs; check \OnlineConvert\Endpoint\JobsEndpoint::setAsync()

You can also set up different headers into the client, and do some process using the token of a job.

Manage exceptions

If you catch \OnlineConvert\Exception\OnlineConvertSdkException::class, you automatically catch all exception in this SDK

Getting url to upload file

• Send a job request

• Take the following keys from a job: server and id. You can use \OnlineConvert\Api or \OnlineConvert\Endpoint\JobsEndpoint to get the job information. You will get something like:

• Now with this information you can make this call:

• Also these token can be useful for some operations that you might want to share with your users

Uploading files directly to the Online-Convert.com servers via AJAX

Real life case: I want to send our user files directly to the API, because sending them to my app first and then to the API costs too much time.

Considerations: Normally, this will save us process time, space on the hard drive and improve user experience, but it's advised to have a fallback alternative that works without using JS.

The following example is using JQuery.

IMPORTANT: The upload MUST be done one by one. Thus, you need one form per file.

HTML CODE

JS