- Do I need to use cURL to make API requests?
- How do I send files using cURL?
- Can I call my API directly from a browser or mobile device/application? Can I make AJAX calls to my API?
- How many concurrent operations can be done?
- What programming language can be used to connect with the API?
- Can I use the API explorer on my site?
- How do I access my image collection?
- How do I access my query images?
- How long are query and overlay images stored for?
- Can I clear my API’s image collection?
- What image formats do the APIs accept?
- What is the suggested size for images?
- Are folders for images created dynamically?
- I only see 20 images when I list my collection, what’s going on?
Do I really need to provide my server’s IP address?¶
Providing your IP addresses is optional, but is highly recommended if your servers have static IP addresses. IP address based filtering is more secure than using password-based authentication, but we support both.
If you are unsure of your IP address, run the following from your server(s):
That command will return your IP address, which will be four numbers separated by periods,
How can I add or remove IP addresses?¶
Registered IP(s) that can connect to your API appear in your dashboard. You can directly edit your registered IP list from that page.
If you are currently setup for password-based authentication, then instead of an IP list there will be a “contact us” link to enable IP-based authentication.
Can I add a range of IP addresses?¶
Yes, our IP authentication system accepts IP address ranges. When setting up your IP-based security for the first time, or when adding or removing IP addresses in your dashboard, simply enter the range in CIDR notation. For example, 10.10.8.0/29.
What should I do if I have a dynamic IP?¶
IP Filtering does not work with dynamic IP addresses. Please use services.tineye.com/support to request a user name and password to log in with. We will also turn off IP-based authentication for you.
Why am I getting a 500 error?¶
This may be because the HTTP request sent was malformed; common problems include missing multipart boundaries or the last boundary not ending with “–”. If checking the validity of your HTTP request doesn’t solve your problem, please send us the details of the request you sent and the response you got using services.tineye.com/support and we will get back to you as soon as possible.
Do I need to use cURL to make API requests?¶
No, you can use any method which sends HTTP requests to the server, and retrieves the results. All major programming languages and platforms have HTTP libraries, and you should use one for your development environment. We use curl in our examples because it is a handy way to try it out from a terminal, and to make simple scripts.
How do I send files using cURL?¶
You can find an example on the Requests page. Be careful about the use of images, filepaths and @; their meanings are not obvious.
Can I call my API directly from a browser or mobile device/application? Can I make AJAX calls to my API?¶
Your API should only be called from your server’s scripts and never from a browser or a mobile application. Otherwise you would expose your API to the public, which would allow anyone to add and delete images from your collection.
How many concurrent operations can be done?¶
What programming language can be used to connect with the API?¶
Can I use the API explorer on my site?¶
You can, but you must proxy the calls to the API, or use wrappers to make those calls from your own site. This is necessary because of the AJAX same-origin policy, which enhances security.
How do I access my image collection?¶
You can view your collection images by accessing the following URL:
How do I access my query images?¶
You can view query images by accessing the following URL:
How long are query and overlay images stored for?¶
Overlay and query images are stored for one day.
Can I clear my API’s image collection?¶
Please contact us if you wish to clear your image collection.
What image formats do the APIs accept?¶
WineEngine accepts JPEG, PNG, GIF, BMP and TIFF images. Animated images are not supported. The format is found from the file content; the associated filename extension, if any, is ignored.
What is the suggested size for images?¶
Images should be 600 pixels in the smaller dimension for WineEngine. Images larger than optimal will be resized by the API. For example, a 1200x900 pixels image will be resized to 800x600 pixels by WineEngine. To reduce upload time, it is recommended that you pre-scale your images accordingly.
Are folders for images created dynamically?¶
Yes. They are created when images are uploaded, using the path in the filepath parameter.