Download a person asset by asset ID

curl --request GET \
  --url https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download \
  --header 'Authorization: <api-key>'

import requests

url = "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

"<string>"

Profile Assets

Download a person asset by asset ID

Streams the binary or text content of the asset identified by assetId. Returns HTTP 302 if the content is hosted at a remote URL; returns HTTP 200 with the raw content otherwise. Use the name variant (downloadPersonAssetByName) when you have the asset name but not the id. The access token is optional on this operation: omit it and Extole serves only the person’s PUBLIC assets, resolving the client from the request domain. Supply a token belonging to the person to reach their PRIVATE assets. Omitting the token is the recommended way to render another person’s avatar, so no token has to be embedded in an image URL.

GET

api

persons

{personId}

assets

{assetId}

download

Download a person asset by asset ID

curl --request GET \
  --url https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download \
  --header 'Authorization: <api-key>'

import requests

url = "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download"

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

	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{brand}.extole.io/api/v4/persons/{personId}/assets/{assetId}/download")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

"<string>"

Authorizations

Authorization

string

header

required

Path Parameters

personId

string

required

The Extole unique profile identifier of this user at Extole.

assetId

string

required

The Extole-assigned unique identifier of the asset.

Response

Binary asset content stream with the asset's stored content type.

The response is of type file.

⌘I

Getting Started

Consumer to Extole API

Server to Extole API

Management API

Download a person asset by asset ID

Authorizations

Path Parameters

Response