WoyraDocs
Get an API key

A company's logo, by signed link

GET/v1/mail/logos/{domain}

Mailboxes · Public: no credential needed

The image behind a logoUrl. The link is the credential: signed and good for a day, so an <img> can load it without a token.

Woyra fetches the logo from the company's own site, never the reader's device: /apple-touch-icon.png, then the icons the home page links to, then /favicon.ico when it holds a PNG; over HTTPS only, through a client that reaches only public addresses. Whatever is found is decoded and drawn anew as a 128x128 PNG, so nothing of the original file is passed on, and an icon smaller than 48 pixels is not used. The answer is cached per domain: a logo for 30 days, the absence of one for 7.

Parameters

NameInDescription
domainrequiredpathThe organisation domain, e.g. acme.co.uk for mail from news.acme.co.uk.
expiresrequiredquery
signaturerequiredquery

Example

curl https://api.woyra.io/v1/mail/logos/<domain>

Response

200 The logo, 128x128.

Errors

StatusCodes
404not_found, product_not_offered

Also in Mailboxes