Skip to content

Fetch the logo a hosted page shows

GET
/l/{token}
curl --request GET \
--url 'https://api.pixonaut.app/l/example?fit=cover'

Operation ID: logos.get

The image a tenant’s hosted pages show as its logo, through the link their share link’s page is answered with. The token in the path is signed by the api and expires within two hours; no key is needed. A link to a logo the tenant has since replaced or cleared no longer opens. width serves it no larger than the box it is drawn in.

token
required
string
width

The width in pixels the image is drawn at. The long edge served is derived from the image’s own ratio, never larger than the stored image, and clamped to the sizes the api serves.

string
/^\d+$/

The width in pixels the image is drawn at. The long edge served is derived from the image’s own ratio, never larger than the stored image, and clamped to the sizes the api serves.

fit

cover when the image is cropped to fill its box: width is then its short edge.

string
Allowed values: cover

cover when the image is cropped to fill its box: width is then its short edge.

The file’s bytes

string
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

x-pixonaut-original-height
integer

The uploaded file’s height in pixels, when it is known. The bytes served may be a smaller preview.

x-pixonaut-original-width
integer

The uploaded file’s width in pixels, when it is known. The bytes served may be a smaller preview.

Not modified: the If-None-Match etag still holds

X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

The token does not verify or has expired, or the image is no longer the tenant’s logo (plain text)

X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: invalid_query

Media typeapplication/json
object
error
required
string

Examples

Exampleinvalid_query

invalid_query

{
"error": "invalid_query"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Refused: rate_limited

Media typeapplication/json
object
error
required
string

Examples

Examplerate_limited

rate_limited

{
"error": "rate_limited"
}
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

The request failed unexpectedly.

Media typetext/plain
string
Allowed value: Internal Server Error
X-Request-Id
required
string

Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.

Questions? Write to [email protected].

Status · Terms of service · Privacy policy · Subprocessors