GET get_info

Given a list of file paths, check if the associated images are present in the collection.

Resource URL

https://mobileengine.tineye.com/<company>/rest/get_info/

Notes

For each image return its status (healthy, missing), the insertion date, the image’s dimensions (width, height) and a fingerprint health percentage (0% to 100%).

Each request accepts maximum 10 filepaths.

Parameters

In addition to the Common parameters there are:

Filepath

Key

Description

filepath

Info will be returned for this filepath.

Filepaths

Key

Description

filepaths[0]

Info will be returned for this filepath.

filepaths[n] (optional)

Info will be returned for this filepath.

Request example

curl https://mobileengine.tineye.com/<company>/rest/get_info/   \
     -d "filepath=path/folder/1.jpg"

or

curl https://mobileengine.tineye.com/<company>/rest/get_info/   \
     -d "filepaths[0]=path/folder/1.jpg"                        \
     -d "filepaths[1]=path/folder/2.jpg"                        \
     -d "filepaths[2]=path/folder/3.jpg"                        \
     -d "filepaths[3]=path/folder/4.jpg"

Response examples

JSON

{
    "method": "get_info",
    "status": "ok",
    "error": [],
    "result": [
        {
            "filepath": "path/folder/1.jpg",
            "width": 600,
            "height": 800,
            "fingerprint": 100,
            "date": "2022-10-22",
            "status": "healthy"
        },
        {
            "filepath": "path/folder/2.jpg",
            "width": 600,
            "height": 600,
            "fingerprint": 67.45,
            "date": "2023-01-10",
            "status": "healthy"
        },
        {
            "filepath": "path/folder/3.jpg",
            "width": 0,
            "height": 0,
            "fingerprint": 0,
            "date": "0000-00-00",
            "status": "missing"
        },
        {
            "filepath": "path/folder/4.jpg",
            "width": 750,
            "height": 500,
            "fingerprint": 15.69,
            "date": "2023-02-15",
            "status": "healthy"
        }
    ],
    "stats": {
        "time_get_info": 13.2,
        "time_total": 13.56
    }
}

XML

<?xml version="1.0" encoding="utf-8"?>
<data>
    <method>get_info</method>
    <status>ok</status>
    <error/>
    <result>
        <item>
            <filepath>path/folder/1.jpg</filepath>
            <width>600</width>
            <height>800</height>
            <fingerprint>100</fingerprint>
            <date>2022-10-22</date>
            <status>healthy</status>
        </item>
        <item>
            <filepath>path/folder/2.jpg</filepath>
            <width>600</width>
            <height>600</height>
            <fingerprint>67.45</fingerprint>
            <date>2023-01-10</date>
            <status>healthy</status>
        </item>
        <item>
            <filepath>path/folder/3.jpg</filepath>
            <width>0</width>
            <height>0</height>
            <fingerprint>0</fingerprint>
            <date>0000-00-00</date>
            <status>missing</status>
        </item>
        <item>
            <filepath>path/folder/4.jpg</filepath>
            <width>750</width>
            <height>500</height>
            <fingerprint>15.69</fingerprint>
            <date>2023-02-15</date>
            <status>healthy</status>
        </item>
    </result>
    <stats>
        <time_get_info>13.2</time_get_info>
        <time_total>13.56</time_total>
    </stats>
</data>