Requests¶

To run these examples you will need to substitute your company name for your WineEngine server (as supplied by TinEye) in place of <company>. There is no test server available.

For security reasons, do not call the API directly from a client-side machine. Doing so would expose your password, and allow anyone to delete your images or add their own.

An example call to list the images in your WineEngine collection:

https://wineengine.tineye.com/<company>/rest/list/

This call can be made from a web browser for debugging purposes.

Image queries and uploads are submitted in a request equivalent to an enctype="multipart/form-data" form.

Here is an add example using cURL:

curl https://wineengine.tineye.com/<company>/rest/add/     \
     -F "image=@1.jpg"                                     \
     -F "filepath=path/to/file.jpg"

The first -F option (image=@1.jpg) points to the file on your local machine. The second -F option (filepath=path/to/file.jpg) is the file path that you would like to give to the image on the WineEngine server. If filepath is omitted, the file’s local path will be used.

The file path can be any arbitrary identifier you like for the image, and it does not need to end with .jpg or any other file extension. It is important that the file paths be unique because images with the same path will overwrite each other.

https://wineengine.tineye.com/<company>/rest/list/?format=xml

handle_results( ...json output... );