Signed image links
Creative images are served through signed links. A link names one image of one organization and carries its
own proof, so it works in an <img> tag or a download without an API key. Treat a link like a short-lived secret:
anyone who has it can open the image until it expires.
Links in API responses
Section titled “Links in API responses”imageUrl in creatives, Playground images and incidents looks like:
https://api.ad80.dev/v1/images/<org>/<contentHash>?exp=<unix seconds>&sig=<hex>- It expires 10 minutes after the response was made;
imageUrlExpiresAtsays when. - After that it answers 403 (
image link expired). Request the creative again for a fresh link. - The image is a PNG (
Content-Type: image/png). The response allows cross-origin use, so you can show it on your own pages. - A link whose signature was changed answers 403; a link for an image your organization does not have answers 404.
Links in notifications
Section titled “Links in notifications”E-mails and webhooks carry a longer-lived link of the form:
https://api.ad80.dev/v1/creatives/<contentHash>/image?exp=<unix seconds>&org=<org>&sig=<hex>It stays valid for 7 days. An expired link answers 410. A webhook subscription with attach_image also carries
the image itself, base64-encoded, in the payload (see Webhook events).
Keeping images
Section titled “Keeping images”If you need images for longer (for an archive or an evidence file), download them while the link is valid and store them yourself.