Data integrations

Create and manage data integrations from the Integrations section. Click Add integration to create a new integration.

Encord can integrate with:


Sharing cloud integrations

Sharing cloud integrations allows other users to use the integration to upload data to the Encord platform. All integrations can be shared with other users with the following procedure, regardless of the cloud service provider the integration comes from.

To share an integration:

  1. Click the Share integration button on the integration.
  2. Type the emails of the users you want to share the integration with.
  3. Click Share.

Strict client-only access

Strict client-only access allows Encord to sign URLs without temporarily processing information on our servers. Strict client-only access is available for all types of private cloud integrations, including Direct access.

ℹ️

Note

Strict client-only access only supports video.

There are two main consequences of making an integration client-only access:

  1. All features that rely on any kind of data conversion will won't work. This includes features such as:
  1. Metadata must be specified for all data in the JSON file when adding data to a dataset. The video metadata section shows how to specify the metadata.

Video metadata

Since Strict client-only access prevents Encord from processing video information on ours servers, this information needs to be supplied in the form of the videoMetadata key. The videoMetadata key must be included in the JSON file used to add videos using Strict client-only access to a dataset.

👍

Tip

Encord assumes the videoMetadata is correct and our servers will not download or pre-process your data. This is particularly useful for customers with strict data compliance concerns.

ℹ️

Note

videoMetadata is distinct from clientMetadata. videoMetadata is required for videos when using Strict client-only access, while clientMetadata is optional and can be included for all types of data.

One way to find the required metadata is shown below. Run the following commands in your terminal.

  • ffmpeg -i 'video_title.mp4' to retrieve fps, duration, width, and height:
  • ls -l 'video_title.mp4' to retrieve the file size:

Example JSON including video metadata
{
    "videos": [
      {
        "objectUrl": "video_file.mp4",
        "videoMetadata": {
            "fps": 23.98,
            "duration": 29.09,
            "width": 1280,
            "height": 720,
            "file_size": 5468354,
            "mime_type": "video/mp4"
        }
      }
    ]
  }

  • fps: Frames per second.
  • duration: Duration of the video (in seconds).
  • width / height: Dimensions of the video (in pixels).
  • file_size: The size of the file (in bytes).
  • mime_type: Specifies the file type extension according to the MIME standard.

Enabling Strict client-only access

Strict client-only access is enabled by checking the Strict client-only access, server-side media features will not be available checkbox when creating an integration.

A green tick and the words Client-only access are visible on all client-only access integrations.