Skip to content

ConvertAPI

The ConvertAPI modules allow you to upload and convert the files in your ConvertAPI account.

Getting Started With ConvertAPI

Prerequisites

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting ConvertAPI to Ibexa Connect

To connect your ConvertAPI account to Ibexa Connect, you'll need to obtain the secret value from your ConvertAPI account, and insert it into the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your ConvertAPI account, and copy the secret value to your clipboard.

    61f26aa834158.png

  2. Go to Ibexa Connect, and open the ConvertAPI module's Create a connection dialog.

    61f26aa92bf1f.gif

  3. In the Connection name field, enter a name for the connection.

  4. In the Secret field, enter the secret valued copied in step 1, and click Continue.

The connection has been established.

Files

Upload a File

Uploads a file and returns a File ID to be used for conversions.

File Adding Method

Select the option to upload the file:

  • Upload as a file

  • Upload from Remote Server

File

Enter (map) the file data.

File Name

Enter (map) the file name with extension. For example, image.jpg.

File URL

Enter (map) the URL address of the file.

Convert a File

Converts a file from one format to another.

Fill in Parameters

Select the option to fill in the details of the file you want to convert.

From Format

Select or map the format of the file you want to convert.

To Format

Select or map the format to which you want to convert the file. Based on the format selected, fill in the dynamic fields that auto-populate.

File Adding Method

Select the option to upload the file:

  • Upload as a file

  • Upload from Remote Server

File ID

Enter (map) the File ID you want to convert.

File

Enter (map) the file data.

File Name

Enter (map) the file name with extension. For example, image.jpg.

File URL

Enter (map) the URL address of the file.

Document Password

Enter (map) the password for the document.

Store File

Select whether you want to store the file.

Timeout

Enter (map) the seconds used when storing the files on the ConvertAPI server. Enter a value between 10 and 1200.

Other

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://v2.convertapi.com For example: /upload

For the list of available endpoints, please refer to the ConvertAPI API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we've already done that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Download a File

The following API call returns all the specified file details from your ConvertAPI account:

URL:

/d/1b5453380bb3e0ef5430af809fd4a1da

Method:

GET

61f26aab65057.png

Matches of the search can be found in the module's Output under Bundle >Body.

In our example, the specified file details were returned:

61f26aac7912c.png