Get a file resource thumbnail

GET

/customer-api/v1/file/{fileUuid}/thumbnail

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail',
  params: {width: '300', height: '200'},
  headers: {Authorization: 'Bearer <token>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail";

    let querystring = [
        ("width", "300"),
        ("height", "200"),
    ];

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .headers(headers)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request GET \
  --url 'https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200' \
  --header 'Authorization: Bearer <token>'

wget --quiet \
  --method GET \
  --header 'Authorization: Bearer <token>' \
  --output-document \
  - 'https://your-instance.seventhings.com/customer-api/v1/file/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/thumbnail?width=300&height=200'

Get a file resource thumbnail, by default 150 x 100 pixels. With width and height any other size within the limits is created on first request and reused afterwards. The picture is scaled to fit the requested box and keeps its aspect ratio. A file keeps a limited number of sizes besides the default one; once it has that many, a further new size is answered with 422, while the stored sizes and the default stay available.

Authorizations

bearerAuth

Parameters

Path Parameters

fileUuid

required

string format: uuid

Query Parameters

width

integer

>= 1 <= 2000

Width of the thumbnail in pixels. Has to be sent together with height. The first request for a size creates the thumbnail and stores it; every later request for the same size hands out the stored one.

Example

height

integer

>= 1 <= 2000

Height of the thumbnail in pixels. Has to be sent together with width. Without both parameters the thumbnail is 150 x 100 pixels.

Example

Responses

200

The file resource thumbnail

application/octet-stream

string format: binary

400

Request body is missing or invalid or request data is invalid.

401

Access token is missing or invalid.

403

You are not permitted to perform the requested operation.

404

The requested resource could not be found.

406

The requested resource representation has no acceptable format.

422

The requested entry is not processable.

500

Internal Server Error.