UFIS! uses a minimal GIFT HTTP API

(APLHA).

Requests are REST:

It's a one method only API. Simply GET a URL like this:

http://www.khm.de/~lscherff/GIFT-API/?argument1=values&argument2=values

Possible arguments are:

results -- The number of results requested. Default is 0.
examples -- A comma separated list of URLs of example images for Query by Example (QBE). For each example there must be a relevance value. If no examples are given random images are returned.
relevances -- A comma separated list of relevance values (the i-th entry being the relevance of the i-th example image) for QBE.

Return values are XML (or MRML):

The MRML-Answer of the GIFT server behind the API is returned. If the API produces an error a simple MRML error message is returned.

Examples:

http://www.khm.de/~lscherff/GIFT-API/?

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 
<mrml  just-for-test="and-of-course-for-fun" session-id="5fbb352d-3d37-41fd-ad05-57dcabb4a5ec" >
    <cui-time-stamp  calendar-time="Thu Jun 22 10:33:56 2006
" />
    <acknowledge-session-op  session-id="5fbb352d-3d37-41fd-ad05-57dcabb4a5ec" />
    <query-result  >
        <query-result-element-list  />
    </query-result>
    <cui-time-stamp  calendar-time="Thu Jun 22 10:33:56 2006
" />
</mrml>

http://www.khm.de/~lscherff/GIFT-API/?results=5

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 
<mrml  just-for-test="and-of-course-for-fun" session-id="754c4690-782a-4246-9117-f0dd77e46e92" >
    <cui-time-stamp  calendar-time="Thu Jun 22 10:38:59 2006
" />
    <acknowledge-session-op  session-id="754c4690-782a-4246-9117-f0dd77e46e92" />
    <query-result  >
        <query-result-element-list  >
            <query-result-element  calculated-similarity="1.000000" image-location="http://static.flickr.com/77/165684634_2572a7eaa5_m.jpg" thumbnail-location="http://static.flickr.com/77/165684634_2572a7eaa5_t.jpg" />
            <query-result-element  calculated-similarity="1.000000" image-location="http://static.flickr.com/50/166556418_c53071955f_m.jpg" thumbnail-location="http://static.flickr.com/50/166556418_c53071955f_t.jpg" />
            <query-result-element  calculated-similarity="1.000000" image-location="http://static.flickr.com/46/166484078_fd3095dee3_m.jpg" thumbnail-location="http://static.flickr.com/46/166484078_fd3095dee3_t.jpg" />

            <query-result-element  calculated-similarity="1.000000" image-location="http://static.flickr.com/63/166585953_36ef688647_m.jpg" thumbnail-location="http://static.flickr.com/63/166585953_36ef688647_t.jpg" />
            <query-result-element  calculated-similarity="1.000000" image-location="http://static.flickr.com/49/166410790_fe0c4c8b8b_m.jpg" thumbnail-location="http://static.flickr.com/49/166410790_fe0c4c8b8b_t.jpg" />
        </query-result-element-list>
    </query-result>
    <cui-time-stamp  calendar-time="Thu Jun 22 10:38:59 2006
" />
</mrml>

http://www.khm.de/~lscherff/GIFT-API/?results=5&examples=http://www.khm.de/~lscherff/ufis/ufis.gif&relevances=1.0

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 
<mrml  just-for-test="and-of-course-for-fun" session-id="5607645b-3e8d-4755-ad64-a5dd0e1b76ad" >
    <cui-time-stamp  calendar-time="Thu Jun 22 10:40:56 2006
" />
    <acknowledge-session-op  session-id="5607645b-3e8d-4755-ad64-a5dd0e1b76ad" />
    <query-result  >l
        <query-result-element-list  >
            <query-result-element  calculated-similarity="0.533935" image-location="http://static.flickr.com/73/163212629_ba3c135f5a_m.jpg" thumbnail-location="http://static.flickr.com/73/163212629_ba3c135f5a_t.jpg" />
            <query-result-element  calculated-similarity="0.518889" image-location="http://static.flickr.com/74/166549305_291165e251_m.jpg" thumbnail-location="http://static.flickr.com/74/166549305_291165e251_t.jpg" />
            <query-result-element  calculated-similarity="0.498365" image-location="http://static.flickr.com/71/166545491_6f9c0090a2_m.jpg" thumbnail-location="http://static.flickr.com/71/166545491_6f9c0090a2_t.jpg" />

            <query-result-element  calculated-similarity="0.497127" image-location="http://static.flickr.com/45/166412465_47c3aed714_m.jpg" thumbnail-location="http://static.flickr.com/45/166412465_47c3aed714_t.jpg" />
            <query-result-element  calculated-similarity="0.487011" image-location="http://static.flickr.com/45/166516857_ed96d82ce7_m.jpg" thumbnail-location="http://static.flickr.com/45/166516857_ed96d82ce7_t.jpg" />
        </query-result-element-list>
    </query-result>
    <cui-time-stamp  calendar-time="Thu Jun 22 10:41:01 2006
" />
</mrml>

http://www.khm.de/~lscherff/GIFT-API/?examples=1.0&relevances=no

<?xml version="1.0" standalone="no" ?><!DOCTYPE mrml SYSTEM "http://isrpc85.epfl.ch/Charmer/code/mrml.dtd"><mrml><error message="bad image url: 1.0" /></mrml>

Credits:

This API is written in PHP and based on:

A PHP MRML client by Nicolas Chabloz
Another PHP MRML client by Tuurlijk!

khm.de