Frequently Asked Question about the API

Q: What kind of authentication is used for the API ?

A: The API uses Basic Authentication

Basic Authentication requires your HTTP request to contain the specific header Authorization. Four simple steps are required to set the header to the correct value:

1. Username and password are combined into a string "username:password"
2. The resulting string is encoded using Base64
3. The authorization method and a space i.e. "Basic " should be preprended to the encoded string
4. The value of the Authorization header should be set to the resulting string

For your username is "ltu" and your password is "technologies" then the Authorization header should look like:

Basic bHR1OnRlY2hub2xvZ2llcw==

You can find all about Basic Authentication on Wikipedia. 

Q: Why do I get an 301 HTTP when doing requests to the API

A: Our servers will return a 301 HTTP code if your request is not using HTTPS

All the requests to the API should be using HTTPS this way all the data transferred is encrypted and secured. So make sure to direct your requests to the correct URL:

curl -i -u ltu:technologies https://cloud.ltutech.com/api/v1/projects/

Q: My client is complaining about TLS/SSL certificate ?

A: You should download our certificate from your browser and specify its path to your client

If during testing - with curl for example - you get an error that looks like this:

curl: (60) SSL certificate problem, verify that the CA cert is OK.

you need to download LTU's certificate.

For the current user if the certificate is named ltutech.com.cacert you can specify its path in a curl command for example:

curl -i -u ltu:technologies --cacert ~/ltutech.com.cacert https://cloud.ltutech.com/api/v1/projects/

Q: How do I delete or modify multiple Visuals / Images / Metadata?

A: You need to send separated API requests for each Resource to delete or to modify

For example, to delete all the Visuals within a given project you could launch the following bash script:

#!/bin/bash
PROJECT_ID="1"
CREDENTIALS="ltu:technologies"

while true; do
  # build the list of the first Visual URLs
  visual_urls=$(curl -u $CREDENTIALS https://cloud.ltutech.com/api/v1/projects/$PROJECT_ID/visuals/ \
                | egrep -o 'https://cloud.ltutech.com/api/v1/projects/visuals/[0-9]*/' | uniq)
  # Process the Visuals one by one
  for visual in $visual_urls; do
    curl -u $CREDENTIALS -X DELETE $visual
  done
  # exit when the list is empty
  [ "$visual_urls" != "" ] || break
done

If you have any questions regarding our API or couldn't find what you were looking for on this page please feel free to send an email to our Support Team