Connecting external services

If your tasks require images or other files with data, it is convenient to store them on Yandex.Disk. To do this, create a special folder on Yandex.Disk and link it to Toloka. You can only use files from Yandex.Disk for the same Yandex account that you are using on Toloka.

Tasks can also use data from other HTTP services. For example, you can enable the geo service and get data from it about objects on the map for displaying in tasks. To do this, you need to link the HTTP service to Toloka.

Yandex.Disk

To use Yandex.Disk as a data source:

  1. Click Add Ya.Disk on the profile page (the External Services Integration tab) and allow Toloka access to Yandex.Disk.

  2. Click Add proxy and fill in the fields:

    Field

    Description

    Unique name

    Name of the data source. The name will be inserted in the file URLs. Allowed characters: Latin letters, numbers, and dash (“-”).

    Type

    Choose “Yandex.Disk”.

    Permissions

    Level of access to files:

    • “Public” — All Toloka users (appropriate for files with instructions).

    • “Private” — Only users who received a task with this file (appropriate for task content).

    Folder name

    The name of the folder on Yandex.Disk. A folder with this name will be created on Yandex.Disk automatically (Applications/Yandex.Toloka/<folder name>). The slash (“/”) is not allowed in the folder name.

  3. Click Save.

The folder Applications/Yandex.Toloka/<folder name> will be created on Yandex.Disk. Upload images or other files for tasks to it.

Adding images from Yandex.Disk

To insert an image in the instructions for a project, use a link in the format <unique name>/<file name>. For example: pics/image1.jpg.

To add an image to tasks:

  1. Specify the string data type for the input field that you are going to use for the image link.

  2. Insert the image in the task interface with the standard <img> HTML tag. Put the proxy Handlebars component and the ID of the input field in the src attribute. For example: <img src={{proxy image}} width="400">.

  3. Include relative links to Yandex.Disk files in the TSV file with tasks. For example, pics/image1.jpg.