Response [200 Ok]
| Uri | /api/v2/image/tWnHGNs-0 |
|---|---|
| UriDescription | Image by key |
| DocUri | https://api.smugmug.com/api/v2/doc/reference/image.html |
| EndpointType | Image |
| Locator | Image |
| LocatorType | Object |
Image [1 of 1]
- THE TROUBADOUR - Act IV, Part 2
/api/v2/image/tWnHGNs-0
| Uri | /api/v2/image/tWnHGNs-0 |
|---|---|
| UriDescription | Image by key |
| Altitude | 0 |
| ArchivedMD5 | d9d33e5f7d1c25bca55e2911df07502d |
| ArchivedSize | 1018869 |
| ArchivedUri | https://photos.smugmug.com/Performing-Arts/Troubadour-Parma/i-tWnHGNs/0/LjJRD5cgXP3j5Vx22xRrNmzqtSFmjbj4RRfLFTRB7/D/74%20Act%204%20part%202%202018LTRO092112-D.jpg |
| CanBuy | false |
| CanEdit | false |
| CanShare | true |
| Caption | Photograph © Lucie Jansch THE TROUBADOUR by Giuseppe Verdi French version "Le Trouvère" Teatro Farnese / Verdi Festival Parma, Italy Opening on September 29, 2018 Direction and Design by Robert Wilson Costumes by Julia von Leliwa |
| Collectable | true |
| Comments | true |
| ComponentFileTypes | |
| Date | 2018-10-17T19:34:27+00:00 |
| DateTimeOriginal | 2018-09-22T00:17:03+00:00 |
| DateTimeUploaded | 2018-10-17T19:34:27+00:00 |
| EZProject | false |
| FileName | 74 Act 4 part 2 2018LTRO092112.jpg |
| Format | JPG |
| Hidden | false |
| ImageKey | tWnHGNs |
| IsArchive | false |
| IsVideo | false |
| KeywordArray | |
| Keywords | empty string |
| LastUpdated | 2018-10-17T19:43:18+00:00 |
| Latitude | 0 |
| Longitude | 0 |
| OriginalHeight | 2282 |
| OriginalWidth | 3543 |
| PreferredDisplayFileExtension | JPG |
| Processing | false |
| Protected | true |
| Serial | 0 |
| ShowKeywords | true |
| Status | Open |
| SubStatus | NFS |
| ThumbnailUrl | https://photos.smugmug.com/Performing-Arts/Troubadour-Parma/i-tWnHGNs/0/M7WgZD9sBbrj39zMN4gcfGXZRZbkq7bzXf9qDSW7c/Th/74%20Act%204%20part%202%202018LTRO092112-Th.jpg |
| Title | THE TROUBADOUR - Act IV, Part 2 |
| UploadKey | 7668135993 |
| Watermark | No |
| Watermarked | false |
Formatted Values
Caption [html, text]
| html | Photograph © Lucie Jansch<br /> <br /> THE TROUBADOUR by Giuseppe Verdi<br /> French version "Le Trouvère"<br /> Teatro Farnese / Verdi Festival Parma, Italy<br /> Opening on September 29, 2018<br /> Direction and Design by Robert Wilson<br /> Costumes by Julia von Leliwa |
|---|---|
| text | Photograph © Lucie Jansch THE TROUBADOUR by Giuseppe Verdi French version "Le Trouvère" Teatro Farnese / Verdi Festival Parma, Italy Opening on September 29, 2018 Direction and Design by Robert Wilson Costumes by Julia von Leliwa |
FileName [html, text]
| html | 74 Act 4 part 2 2018LTRO092112.jpg |
|---|---|
| text | 74 Act 4 part 2 2018LTRO092112.jpg |
Uris
ImageComments
/api/v2/image/tWnHGNs-0!comments
| Uri | /api/v2/image/tWnHGNs-0!comments |
|---|---|
| UriDescription | Comments on image |
| EndpointType | ImageComments |
| Locator | Comment |
| LocatorType | Objects |
ImagePricelistExclusions
/api/v2/image/tWnHGNs-0!pricelistexclusions
| Uri | /api/v2/image/tWnHGNs-0!pricelistexclusions |
|---|---|
| UriDescription | Pricelist information for an image |
| EndpointType | ImagePricelistExclusions |
| Locator | ImagePricelistExclusions |
| LocatorType | Object |
ImagePrices
/api/v2/image/tWnHGNs-0!prices
| Uri | /api/v2/image/tWnHGNs-0!prices |
|---|---|
| UriDescription | Purchasable Skus |
| EndpointType | ImagePrices |
| Locator | CatalogSkuPrice |
| LocatorType | Objects |
ImageSizeDetails
/api/v2/image/tWnHGNs-0!sizedetails
| Uri | /api/v2/image/tWnHGNs-0!sizedetails |
|---|---|
| UriDescription | Detailed size information for image |
| EndpointType | ImageSizeDetails |
| Locator | ImageSizeDetails |
| LocatorType | Object |
ImageSizes
/api/v2/image/tWnHGNs-0!sizes
| Uri | /api/v2/image/tWnHGNs-0!sizes |
|---|---|
| UriDescription | Sizes available for image |
| EndpointType | ImageSizes |
| Locator | ImageSizes |
| LocatorType | Object |
LargestImage
/api/v2/image/tWnHGNs-0!largestimage
| Uri | /api/v2/image/tWnHGNs-0!largestimage |
|---|---|
| UriDescription | Largest size available for image |
| EndpointType | LargestImage |
| Locator | LargestImage |
| LocatorType | Object |
PointOfInterest
/api/v2/image/tWnHGNs-0!pointofinterest
| Uri | /api/v2/image/tWnHGNs-0!pointofinterest |
|---|---|
| UriDescription | Point of interest for image |
| EndpointType | PointOfInterest |
| Locator | PointOfInterest |
| LocatorType | Object |
PointOfInterestCrops
/api/v2/image/tWnHGNs-0!poicrops
| Uri | /api/v2/image/tWnHGNs-0!poicrops |
|---|---|
| UriDescription | PointOfInterest Crops for image |
| EndpointType | PointOfInterestCrops |
| Locator | PointOfInterestCrops |
| LocatorType | List |
Regions
/api/v2/image/tWnHGNs-0!regions
| Uri | /api/v2/image/tWnHGNs-0!regions |
|---|---|
| UriDescription | Regions for image |
| EndpointType | Regions |
| Locator | Region |
| LocatorType | Objects |
Request
| Uri | /api/v2/image/tWnHGNs-0 |
|---|---|
| Method | GET |
| Version | v2 |
Config
{
"expand_method": "ref",
"shorturis": false
}
Options
Notes
- The Uri returned by this endpoint may not exist if it was recently uploaded and is being processed
- "Watermark" has been deprecated in favor of "Watermarked". "Watermarked" will only be present for images with a known watermarked state
- Photo sizes, including Original, without a "Size" or "MD5" property, will be generated dynamically upon request
- "ArchivedSize" and "ArchivedMD5" refer to the untouched version of the photo originally uploaded
- "ArchivedUri" will generate a download link for the image based on its source album download settings and owner permissions
Methods
OPTIONS
| Permissions |
|
|---|
GET
| Permissions |
|
|---|
PATCH
| Permissions |
|
|---|
DELETE
| Permissions |
|
|---|
Output Fields
| Altitude | integer | |
|---|---|---|
| ArchivedMD5 | text | |
| ArchivedSize | integer | |
| ArchivedUri | uri | |
| CanBuy | boolean | |
| CanEdit | boolean | |
| CanShare | boolean | |
| Caption | text | |
| Collectable | Deprecated as of 2022-03-09 | |
| Comments | boolean | |
| ComponentFileTypes | hash | |
| Date | Deprecated as of 2020-07-17 | Use DateTimeUploaded |
| DateTimeOriginal | datetimeiso8601 | |
| DateTimeUploaded | datetimeiso8601 | |
| EZProject | boolean | |
| FileName | text | |
| Format | text | |
| FormattedValues | hash | Alternative versions of certain fields formatted for use in different contexts. |
| Hidden | boolean | |
| ImageKey | text | |
| IsArchive | boolean | |
| IsVideo | boolean | |
| KeywordArray | array | |
| Keywords | text | |
| LastUpdated | datetimeiso8601 | |
| Latitude | decimal | |
| Longitude | decimal | |
| OriginalHeight | integer | |
| OriginalSize | integer | |
| OriginalWidth | integer | |
| PreferredDisplayFileExtension | text | Preferred file extension that should be used when displaying this image. If this Image is backed by an Asset with components these will be used for this calculation. |
| Processing | boolean | |
| Protected | boolean | |
| Serial | integer | |
| ShowKeywords | boolean | |
| Status | text | |
| SubStatus | text | |
| ThumbnailUrl | uri | |
| Title | text | |
| UploadKey | Deprecated as of 2022-03-10 | |
| Watermark | Deprecated as of 2014-11-20 | |
| Watermarked | boolean |
JSON
{
"Request": {
"Version": "v2",
"Method": "GET",
"Uri": "/api/v2/image/tWnHGNs-0"
},
"Options": {
"MethodDetails": {
"OPTIONS": {
"Permissions": [
"Read"
]
},
"GET": {
"Permissions": [
"Read"
]
},
"PATCH": {
"Permissions": [
"Modify"
]
},
"DELETE": {
"Permissions": [
"Modify"
]
}
},
"Methods": [
"OPTIONS",
"GET"
],
"MediaTypes": [
"application/json",
"application/vnd.php.serialized",
"application/x-msgpack",
"text/html",
"text/csv"
],
"Output": [
{
"Name": "Title",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Caption",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Keywords",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "KeywordArray",
"Type": "Array",
"ITEM_TYPE": "Varchar",
"MIN_COUNT": 0,
"MAX_COUNT": "INFINITY"
},
{
"Name": "Watermark",
"Type": "Select",
"OPTIONS": [
"No",
"Yes",
"Inherit from Album"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1,
"Deprecated": "2014-11-20"
},
{
"Name": "Latitude",
"Type": "DECIMAL",
"PRECISION": 16,
"SCALE": 14,
"SIGNED": true
},
{
"Name": "Longitude",
"Type": "DECIMAL",
"PRECISION": 17,
"SCALE": 14,
"SIGNED": true
},
{
"Name": "Altitude",
"Type": "Integer",
"MIN_VALUE": 0,
"MAX_VALUE": 16777215
},
{
"Name": "Hidden",
"Type": "Boolean"
},
{
"Name": "ThumbnailUrl",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": []
},
{
"Name": "FileName",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Processing",
"Type": "Boolean"
},
{
"Name": "UploadKey",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY",
"Deprecated": "2022-03-10"
},
{
"Name": "Date",
"Description": "Use DateTimeUploaded",
"Type": "DateTimeISO8601",
"Deprecated": "2020-07-17"
},
{
"Name": "DateTimeUploaded",
"Type": "DateTimeISO8601"
},
{
"Name": "DateTimeOriginal",
"Type": "DateTimeISO8601"
},
{
"Name": "Format",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "OriginalHeight",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "OriginalWidth",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "OriginalSize",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "LastUpdated",
"Type": "DateTimeISO8601"
},
{
"Name": "Collectable",
"Type": "Boolean",
"Deprecated": "2022-03-09"
},
{
"Name": "IsArchive",
"Type": "Boolean"
},
{
"Name": "IsVideo",
"Type": "Boolean"
},
{
"Name": "ComponentFileTypes",
"Type": "Hash"
},
{
"Name": "CanEdit",
"Type": "Boolean"
},
{
"Name": "CanBuy",
"Type": "Boolean"
},
{
"Name": "Protected",
"Type": "Boolean"
},
{
"Name": "EZProject",
"Type": "Boolean"
},
{
"Name": "Watermarked",
"Type": "Boolean"
},
{
"Name": "ImageKey",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Serial",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "ArchivedUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": []
},
{
"Name": "ArchivedSize",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "ArchivedMD5",
"Type": "Text",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Status",
"Type": "Text",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "SubStatus",
"Type": "Text",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "CanShare",
"Type": "Boolean"
},
{
"Name": "Comments",
"Type": "Boolean"
},
{
"Name": "ShowKeywords",
"Type": "Boolean"
},
{
"Name": "FormattedValues",
"Description": "Alternative versions of certain fields formatted for use in different contexts.",
"Type": "Hash"
},
{
"Name": "PreferredDisplayFileExtension",
"Description": "Preferred file extension that should be used when displaying this image. If this Image is backed by an Asset with components these will be used for this calculation.",
"Type": "Text",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
}
],
"Notes": [
"The Uri returned by this endpoint may not exist if it was recently uploaded and is being processed",
"\"Watermark\" has been deprecated in favor of \"Watermarked\".\n \"Watermarked\" will only be present for images with a known watermarked state",
"Photo sizes, including Original, without a \"Size\" or \"MD5\" property, will be generated dynamically upon request",
"\"ArchivedSize\" and \"ArchivedMD5\" refer to the untouched version of the photo originally uploaded",
"\"ArchivedUri\" will generate a download link for the image based on its source album download settings and owner permissions"
],
"Path": [
{
"type": "path",
"text": "api"
},
{
"type": "path",
"text": "v2"
},
{
"type": "path",
"text": "image"
},
{
"type": "singleparam",
"param_name": "imagekey",
"param_value": "tWnHGNs-0",
"param_validator": {}
}
]
},
"Response": {
"Uri": "/api/v2/image/tWnHGNs-0",
"Locator": "Image",
"LocatorType": "Object",
"Image": {
"Title": "THE TROUBADOUR - Act IV, Part 2",
"Caption": "Photograph \u00a9 Lucie Jansch\n\nTHE TROUBADOUR by Giuseppe Verdi\nFrench version \"Le Trouv\u00e8re\"\nTeatro Farnese / Verdi Festival Parma, Italy\nOpening on September 29, 2018\nDirection and Design by Robert Wilson\nCostumes by Julia von Leliwa",
"Keywords": "",
"KeywordArray": [],
"Watermark": "No",
"Latitude": "0",
"Longitude": "0",
"Altitude": 0,
"Hidden": false,
"ThumbnailUrl": "https://photos.smugmug.com/Performing-Arts/Troubadour-Parma/i-tWnHGNs/0/M7WgZD9sBbrj39zMN4gcfGXZRZbkq7bzXf9qDSW7c/Th/74%20Act%204%20part%202%202018LTRO092112-Th.jpg",
"FileName": "74 Act 4 part 2 2018LTRO092112.jpg",
"Processing": false,
"UploadKey": "7668135993",
"Date": "2018-10-17T19:34:27+00:00",
"DateTimeUploaded": "2018-10-17T19:34:27+00:00",
"DateTimeOriginal": "2018-09-22T00:17:03+00:00",
"Format": "JPG",
"OriginalHeight": 2282,
"OriginalWidth": 3543,
"LastUpdated": "2018-10-17T19:43:18+00:00",
"Collectable": true,
"IsArchive": false,
"IsVideo": false,
"ComponentFileTypes": [],
"CanEdit": false,
"CanBuy": false,
"Protected": true,
"EZProject": false,
"Watermarked": false,
"ImageKey": "tWnHGNs",
"Serial": 0,
"ArchivedUri": "https://photos.smugmug.com/Performing-Arts/Troubadour-Parma/i-tWnHGNs/0/LjJRD5cgXP3j5Vx22xRrNmzqtSFmjbj4RRfLFTRB7/D/74%20Act%204%20part%202%202018LTRO092112-D.jpg",
"ArchivedSize": 1018869,
"ArchivedMD5": "d9d33e5f7d1c25bca55e2911df07502d",
"Status": "Open",
"SubStatus": "NFS",
"CanShare": true,
"Comments": true,
"ShowKeywords": true,
"FormattedValues": {
"Caption": {
"html": "Photograph \u00a9 Lucie Jansch<br />\n<br />\nTHE TROUBADOUR by Giuseppe Verdi<br />\nFrench version \"Le Trouv\u00e8re\"<br />\nTeatro Farnese / Verdi Festival Parma, Italy<br />\nOpening on September 29, 2018<br />\nDirection and Design by Robert Wilson<br />\nCostumes by Julia von Leliwa",
"text": "Photograph \u00a9 Lucie Jansch\n\nTHE TROUBADOUR by Giuseppe Verdi\nFrench version \"Le Trouv\u00e8re\"\nTeatro Farnese / Verdi Festival Parma, Italy\nOpening on September 29, 2018\nDirection and Design by Robert Wilson\nCostumes by Julia von Leliwa"
},
"FileName": {
"html": "74 Act 4 part 2 2018LTRO092112.jpg",
"text": "74 Act 4 part 2 2018LTRO092112.jpg"
}
},
"PreferredDisplayFileExtension": "JPG",
"Uri": "/api/v2/image/tWnHGNs-0",
"UriDescription": "Image by key",
"Uris": {
"LargestImage": {
"Uri": "/api/v2/image/tWnHGNs-0!largestimage",
"Locator": "LargestImage",
"LocatorType": "Object",
"UriDescription": "Largest size available for image",
"EndpointType": "LargestImage"
},
"ImageSizes": {
"Uri": "/api/v2/image/tWnHGNs-0!sizes",
"Locator": "ImageSizes",
"LocatorType": "Object",
"UriDescription": "Sizes available for image",
"EndpointType": "ImageSizes"
},
"ImageSizeDetails": {
"Uri": "/api/v2/image/tWnHGNs-0!sizedetails",
"Locator": "ImageSizeDetails",
"LocatorType": "Object",
"UriDescription": "Detailed size information for image",
"EndpointType": "ImageSizeDetails"
},
"PointOfInterest": {
"Uri": "/api/v2/image/tWnHGNs-0!pointofinterest",
"Locator": "PointOfInterest",
"LocatorType": "Object",
"UriDescription": "Point of interest for image",
"EndpointType": "PointOfInterest"
},
"PointOfInterestCrops": {
"Uri": "/api/v2/image/tWnHGNs-0!poicrops",
"Locator": "PointOfInterestCrops",
"LocatorType": "List",
"UriDescription": "PointOfInterest Crops for image",
"EndpointType": "PointOfInterestCrops"
},
"Regions": {
"Uri": "/api/v2/image/tWnHGNs-0!regions",
"Locator": "Region",
"LocatorType": "Objects",
"UriDescription": "Regions for image",
"EndpointType": "Regions"
},
"ImageComments": {
"Uri": "/api/v2/image/tWnHGNs-0!comments",
"Locator": "Comment",
"LocatorType": "Objects",
"UriDescription": "Comments on image",
"EndpointType": "ImageComments"
},
"ImagePrices": {
"Uri": "/api/v2/image/tWnHGNs-0!prices",
"Locator": "CatalogSkuPrice",
"LocatorType": "Objects",
"UriDescription": "Purchasable Skus",
"EndpointType": "ImagePrices"
},
"ImagePricelistExclusions": {
"Uri": "/api/v2/image/tWnHGNs-0!pricelistexclusions",
"Locator": "ImagePricelistExclusions",
"LocatorType": "Object",
"UriDescription": "Pricelist information for an image",
"EndpointType": "ImagePricelistExclusions"
}
}
},
"UriDescription": "Image by key",
"EndpointType": "Image",
"DocUri": "https://api.smugmug.com/api/v2/doc/reference/image.html",
"Timing": {
"Total": {
"time": 0.05024,
"cycles": 1,
"objects": 0
}
}
},
"Code": 200,
"Message": "Ok"
}