Thumbnails
For user-uploaded images, some thumbnails are pre-generated. The dimensions and URLs of these thumbnails depend on the
type of image. Images uploaded as attachments to messages always have type Image.
The pregenerated thumbnails are listed below. In addition, since API version 1.3.6, custom formats can be requested.
See Custom Thumbnails.
Note The URLs listed here are relative to the network domain (i.e. yoursubdomain.speakap.com), not the API.
Avatar
Key |
Size WxH |
URL |
iphoneProfileImage |
100x100 |
/files/{eid}/iphone-profile-image |
iphoneProfileImageRetina |
200x200 |
/files/{eid}/iphone-profile-image-retina |
iphoneThumbnail |
35x35 |
/files/{eid}/iphone-thumbnail |
iphoneThumbnailRetina |
70x70 |
/files/{eid}/iphone-thumbnail-retina |
profileImage |
260x260 |
/files/{eid}/profile-image |
thumbnail |
100x100 |
/files/{eid}/thumbnail |
Background image
Key |
Size WxH |
URL |
background |
1440x900 |
/files/{eid}/background |
Login background image
Key |
Size WxH |
URL |
background |
1440x900 |
/files/{eid}/background |
Emblem
Key |
Size WxH |
URL |
iphoneProfileImage |
100x100 |
/files/{eid}/iphone-profile-image |
iphoneProfileImageRetina |
200x200 |
/files/{eid}/iphone-profile-image-retina |
iphoneThumbnail |
35x35 |
/files/{eid}/iphone-thumbnail |
iphoneThumbnailRetina |
70x70 |
/files/{eid}/iphone-thumbnail-retina |
profileImage |
260x260 |
/files/{eid}/profile-image |
thumbnail |
100x100 |
/files/{eid}/thumbnail |
Icon
Key |
Size WxH |
URL |
iphoneThumbnail |
35x35 |
/files/{eid}/iphone-thumbnail |
iphoneThumbnailRetina |
70x70 |
/files/{eid}/iphone-thumbnail-retina |
thumbnail |
100x100 |
/files/{eid}/thumbnail |
Images
Key |
Size WxH |
URL |
iphoneTimeline |
280x280 |
/files/{eid}/iphone-timeline |
iphoneTimelineRetina |
560x560 |
/files/{eid}/iphone-timeline-retina |
iphoneFullscreen |
320x568 |
/files/{eid}/iphone-fullscreen |
iphoneFullscreenRetina |
640x1136 |
/files/{eid}/iphone-fullscreen-retina |
timelinePreviewSmall |
235x235 |
/files/{eid}/timeline-preview-small |
timelinePreviewLarge |
474x360 |
/files/{eid}/timeline-preview-large |
Teaser image
Key |
Size WxH |
URL |
iphoneThumbnail |
35x35 |
/files/{eid}/iphone-thumbnail |
iphoneThumbnailRetina |
70x70 |
/files/{eid}/iphone-thumbnail-retina |
thumbnail |
100x100 |
/files/{eid}/thumbnail |
Custom Thumbnails
Since API version 1.3.6, custom thumbnail sizes can be requested using urls like /files/{eid}/?w=200&h=100
.
The w
and h
parameters represent the desired width and height respectively. The following rules apply
for the returned thumbnail:
- The image will be scaled proportionally. This means when a width of 200 and a height of 100 is requested, the
image will be scaled to fit inside these dimensions, but may not have those exact dimensions if the aspect ratio
of the image is not 2:1
- The image will never be enlarged. If the image already fits within the requested dimensions, it will be returned
in its original size.
- It’s possible to provide only the
w
or h
parameter. The image will be scaled proportionally to fit within
that width or height.
- When a specific thumbnail size is requested for the first time, a lower-quality version may be returned at first. A
high-quality version may be generated asynchronously, so that subsequent requests for that thumbnail will result
in a high-quality thumbnail. Note that the difference between the lower-quality and the high-quality thumbnails is
generally hard to see.
To prevent abuse, not all combinations of width and height are allowed. The following table shows the possible
combinations. For any of the listed combinations, it is also possible to use only one of the components (w or h).
Some values are only allowed for certain kinds of source images.
w |
h |
source |
127 |
80 |
any |
140 |
132 |
any |
140 |
77 |
any |
156 |
110 |
any |
157 |
110 |
any |
170 |
162 |
any |
170 |
107 |
any |
174 |
110 |
landscape |
186 |
186 |
any |
206 |
80 |
any |
236 |
110 |
any |
236 |
236 |
square |
236 |
350 |
portrait |
252 |
276 |
portrait |
252 |
276 |
portrait |
236 |
|
portrait |
300 |
170 |
any |
302 |
326 |
portrait |
390 |
170 |
any |
424 |
|
any |
454 |
|
any |
454 |
350 |
portrait |
454 |
454 |
square |
424 |
163 |
landscape |
474 |
213 |
landscape |
474 |
175 |
landscape |
474 |
100 |
landscape |
468 |
158 |
landscape |
|
236 |
landscape |
|
260 |
any |
|
419 |
portrait |
|
454 |
any |
|
424 |
any |