Constructing URLs

This section describes how to obtain or construct URLs to Zenfolio pages as well as direct image links suitable for displaying to the user. Use these URLs when your application shows links to the user who may copy and use them on a forum, blog, or other website. If your application merely needs to download and display an image, see the Downloading Photos section below.

URLs to Zenfolio Pages

To obtain a URL to a photo, gallery, collection, or group page on Zenfolio, use the PageUrl field of the corresponding snapshot. This field contains a fully formatted URL to the page on Zenfolio site, suitable for linking or displaying to the user.

To construct a URL to user's home page, use the DomainName field from the User snapshot obtained with a call to LoadPublicProfile. The URL can be constructed as follows:

http://{DomainName}/

URLs to Original Files

To obtain a link to the original file, use the OriginalUrl field of the Photo or File snapshot.

Note that Zenfolio does not store the original file for videos. A URL to the highest quality generated video file is returned in the OriginalUrl field for Photo snapshots that represent a video.

URLs to Generated Images and Videos

When your application needs to display a URL to a generated display image to the user, construct the URL as follows:

http://{DomainName}{UrlCore}-{Size}.jpg

Video files have the .mp4 file name extension:

http://{DomainName}{UrlCore}-{Size}.mp4

Where the components of the URL are:

• DomainName is the domain name of the photo owner. Use the DomainName field of the User snapshot to obtain this value.
• UrlCore is the photo URL core that contains the invariant portion of the photo URL. Use the UrlCore field of the Photo or File snapshot to obtain this value
• Size specifies the desired image size. Currently, the following sizes are available for photos:

  Size	Dimensions
  0	Small thumbnail (up to 80 x 80)
  1	Square thumbnail (60 x 60, cropped square)
  2	Small (up to 400 x 400)
  3	Medium (up to 580 x 450)
  4	Large (up to 800 x 630)
  5	X-Large (up to 1100 x 850)
  6	XX-Large (up to 1550 x 960)
  10	Medium thumbnail (up to 120 x 120)
  11	Large thumbnail (up to 120 x 120)

  The following sizes are available for videos:

  Size	Dimensions
  200	1080p resolution (MP4)
  210	720p resolution (MP4)
  215	480p resolution (MP4)
  220	360p resolution (MP4)
  250	Poster frame image (JPEG).

  The following image sizes are available for the user file object that represents the user photo in the user's public profile:

  Size	Dimensions
  50	Large thumbnail (up to 120 x 120)
  51	Small thumbnail (up to 80 x 80)

Only use this URL format when the URL will be saved or embedded into a web page and used later. When your application needs to download and display an image, use the URLs described in the Downloading Photos section.