{
"Request": {
"Version": "v2",
"Method": "GET",
"Uri": "/api/v2/album/HhwMLs"
},
"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": "NiceName",
"Description": "Use UrlName instead",
"Type": "Varchar",
"MIN_CHARS": 1,
"MAX_CHARS": 60,
"Deprecated": "2014-11-20"
},
{
"Name": "UrlName",
"Description": "A human-readable name for use in the URL",
"Type": "Varchar",
"MIN_CHARS": 1,
"MAX_CHARS": 60
},
{
"Name": "Title",
"Description": "Use Name instead",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 255,
"Deprecated": "2014-11-20"
},
{
"Name": "Name",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 255
},
{
"Name": "PrintmarkUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"Printmark"
]
},
{
"Name": "WatermarkUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"Watermark"
]
},
{
"Name": "ThemeUri",
"Description": "Only applies to legacy accounts",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"Theme"
]
},
{
"Name": "TemplateUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"Template"
]
},
{
"Name": "AllowDownloads",
"Type": "Boolean"
},
{
"Name": "Backprinting",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 255
},
{
"Name": "BoutiquePackaging",
"Type": "Select",
"OPTIONS": [
"No",
"Yes",
"Inherit from User"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "CanRank",
"Type": "Boolean"
},
{
"Name": "Clean",
"Type": "Boolean"
},
{
"Name": "Comments",
"Type": "Boolean"
},
{
"Name": "Description",
"Type": "Text",
"MIN_CHARS": 0,
"MAX_CHARS": 65535
},
{
"Name": "DownloadPassword",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 50
},
{
"Name": "EXIF",
"Type": "Boolean"
},
{
"Name": "External",
"Description": "An old setting that no longer has any function",
"Type": "Boolean",
"Deprecated": "2015-09-08"
},
{
"Name": "FamilyEdit",
"Type": "Boolean"
},
{
"Name": "Filenames",
"Type": "Boolean"
},
{
"Name": "FriendEdit",
"Type": "Boolean"
},
{
"Name": "Geography",
"Type": "Boolean"
},
{
"Name": "Header",
"Description": "Appearance",
"Type": "Select",
"OPTIONS": [
"Custom",
"SmugMug"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "HideOwner",
"Type": "Boolean"
},
{
"Name": "InterceptShipping",
"Description": "Personal Delivery",
"Type": "Select",
"OPTIONS": [
"No",
"Yes",
"Inherit from User"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "Keywords",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 255
},
{
"Name": "LargestSize",
"Type": "Select",
"OPTIONS": [
"Medium",
"Large",
"XLarge",
"X2Large",
"X3Large",
"X4Large",
"X5Large",
"4K",
"5K",
"Original"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "PackagingBranding",
"Type": "Boolean"
},
{
"Name": "Password",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 50
},
{
"Name": "PasswordHint",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": 255
},
{
"Name": "Printable",
"Type": "Boolean"
},
{
"Name": "Privacy",
"Description": "\"Private\" is not supported on legacy accounts",
"Type": "Select",
"OPTIONS": [
"Public",
"Unlisted",
"Private"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "ProofDays",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "Protected",
"Description": "Right-Click Protection",
"Type": "Boolean"
},
{
"Name": "Share",
"Type": "Boolean"
},
{
"Name": "Slideshow",
"Type": "Boolean"
},
{
"Name": "SmugSearchable",
"Type": "Select",
"OPTIONS": [
"No",
"Inherit from User"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "SortDirection",
"Type": "Select",
"OPTIONS": [
"Ascending",
"Descending"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "SortMethod",
"Type": "Select",
"OPTIONS": [
"Position",
"Caption",
"Filename",
"Date Uploaded",
"Date Modified",
"Date Taken"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "SquareThumbs",
"Type": "Boolean"
},
{
"Name": "UploadKey",
"Description": "Guest UploadKey",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Watermark",
"Description": "Automatically apply watermark to uploaded images?",
"Type": "Boolean"
},
{
"Name": "WorldSearchable",
"Type": "Boolean"
},
{
"Name": "SecurityType",
"Type": "Select",
"OPTIONS": [
"None",
"Password",
"GrantAccess"
],
"MIN_COUNT": 1,
"MAX_COUNT": 1
},
{
"Name": "CommerceLightbox",
"Type": "Boolean"
},
{
"Name": "HighlightAlbumImageUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"AlbumImage"
]
},
{
"Name": "AlbumTemplateUri",
"Description": "Specify default album presets by providing an AlbumTemplateUri.",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"AlbumTemplate"
]
},
{
"Name": "AlbumKey",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "CanBuy",
"Type": "Boolean"
},
{
"Name": "CanFavorite",
"Type": "Boolean"
},
{
"Name": "FavoriteAlbumUrl",
"Type": "FullUrl",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Date",
"Type": "DateTimeISO8601"
},
{
"Name": "LastUpdated",
"Type": "DateTimeISO8601"
},
{
"Name": "ImagesLastUpdated",
"Description": "The last time at which images were added, removed, or rearranged in this album",
"Type": "DateTimeISO8601"
},
{
"Name": "NodeID",
"Type": "Varchar",
"MIN_CHARS": 1,
"MAX_CHARS": "INFINITY"
},
{
"Name": "OriginalSizes",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "TotalSizes",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "ImageCount",
"Type": "Integer",
"MIN_VALUE": "NEGATIVE_INFINITY",
"MAX_VALUE": "POSITIVE_INFINITY"
},
{
"Name": "UrlPath",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "CanShare",
"Description": "Does the owner of this album want it to be shareable?",
"Type": "Boolean"
},
{
"Name": "HasDownloadPassword",
"Type": "Boolean"
},
{
"Name": "Packages",
"Description": "Are any packages available for album",
"Type": "Boolean"
}
],
"Notes": [
"To sort images manually first set SortMethod to Position",
"When selecting SortMethod=Position, SortMethod is automatically set to Ascending",
"NiceName is deprecated; use UrlName instead",
"Title is deprecated; use Name instead",
"AlbumHighlightImage is deprecated, use HighlightImage instead"
],
"ResponseLevels": [
"Full",
"Password",
"Public",
"GrantAccess"
],
"Path": [
{
"type": "path",
"text": "api"
},
{
"type": "path",
"text": "v2"
},
{
"type": "path",
"text": "album"
},
{
"type": "singleparam",
"param_name": "albumkey",
"param_value": "HhwMLs"
}
]
},
"Response": {
"Uri": "/api/v2/album/HhwMLs",
"Locator": "Album",
"LocatorType": "Object",
"Album": {
"NiceName": "THOMAS-FARTHING-LDN-SS16",
"UrlName": "THOMAS-FARTHING-LDN-SS16",
"Title": "THOMAS FARTHING LDN SS16",
"Name": "THOMAS FARTHING LDN SS16",
"AllowDownloads": false,
"Description": "",
"EXIF": false,
"External": true,
"Filenames": false,
"Geography": true,
"Keywords": "",
"PasswordHint": "",
"Protected": false,
"SortDirection": "Ascending",
"SortMethod": "Position",
"SecurityType": "None",
"CommerceLightbox": false,
"AlbumKey": "HhwMLs",
"CanBuy": false,
"CanFavorite": false,
"LastUpdated": "2016-07-07T16:09:55+00:00",
"ImagesLastUpdated": "2018-02-15T21:05:00+00:00",
"NodeID": "gk63WD",
"ImageCount": 27,
"UrlPath": "/THOMAS-FARTHING-LDN-SS16",
"CanShare": true,
"HasDownloadPassword": false,
"Packages": false,
"Uri": "/api/v2/album/HhwMLs",
"WebUri": "https://www.alexanderbather.com/THOMAS-FARTHING-LDN-SS16",
"UriDescription": "Album by key",
"Uris": {
"AlbumShareUris": {
"Uri": "/api/v2/album/HhwMLs!shareuris",
"Locator": "AlbumShareUris",
"LocatorType": "Object",
"UriDescription": "URIs that are useful for sharing",
"EndpointType": "AlbumShareUris"
},
"Node": {
"Uri": "/api/v2/node/gk63WD",
"Locator": "Node",
"LocatorType": "Object",
"UriDescription": "Node with the given id.",
"EndpointType": "Node"
},
"NodeCoverImage": {
"Uri": "/api/v2/node/gk63WD!cover",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Cover image for a folder, album, or page",
"EndpointType": "NodeCoverImage"
},
"User": {
"Uri": "/api/v2/user/alexanderbather",
"Locator": "User",
"LocatorType": "Object",
"UriDescription": "User By Nickname",
"EndpointType": "User"
},
"Folder": {
"Uri": "/api/v2/folder/user/alexanderbather",
"Locator": "Folder",
"LocatorType": "Object",
"UriDescription": "A folder or legacy (sub)category by UrlPath",
"EndpointType": "Folder"
},
"ParentFolders": {
"Uri": "/api/v2/folder/user/alexanderbather!parents",
"Locator": "Folder",
"LocatorType": "Objects",
"UriDescription": "The sequence of parent folders, from the given folder to the root",
"EndpointType": "ParentFolders"
},
"HighlightImage": {
"Uri": "/api/v2/highlight/node/gk63WD",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Highlight image for a folder, album, or page",
"EndpointType": "HighlightImage"
},
"AlbumHighlightImage": {
"Uri": "/api/v2/album/HhwMLs!highlightimage",
"Locator": "AlbumImage",
"LocatorType": "Object",
"UriDescription": "Highlight image for album",
"EndpointType": "AlbumHighlightImage"
},
"AlbumImages": {
"Uri": "/api/v2/album/HhwMLs!images",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Images from album",
"EndpointType": "AlbumImages"
},
"AlbumPopularMedia": {
"Uri": "/api/v2/album/HhwMLs!popularmedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Popular images from album",
"EndpointType": "AlbumPopularMedia"
},
"AlbumGeoMedia": {
"Uri": "/api/v2/album/HhwMLs!geomedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Geotagged images from album",
"EndpointType": "AlbumGeoMedia"
},
"AlbumComments": {
"Uri": "/api/v2/album/HhwMLs!comments",
"Locator": "Comment",
"LocatorType": "Objects",
"UriDescription": "Comments on album",
"EndpointType": "AlbumComments"
},
"AlbumPrices": {
"Uri": "/api/v2/album/HhwMLs!prices",
"Locator": "CatalogSkuPrice",
"LocatorType": "Objects",
"UriDescription": "Purchasable Skus",
"EndpointType": "AlbumPrices"
},
"AlbumPricelistExclusions": {
"Uri": "/api/v2/album/HhwMLs!pricelistexclusions",
"Locator": "AlbumPricelistExclusions",
"LocatorType": "Object",
"UriDescription": "Pricelist information for an Album",
"EndpointType": "AlbumPricelistExclusions"
}
},
"ResponseLevel": "Public"
},
"UriDescription": "Album by key",
"EndpointType": "Album",
"DocUri": "https://api.smugmug.com/api/v2/doc/reference/album.html",
"Timing": {
"Total": {
"time": 0.0238,
"cycles": 1,
"objects": 0
}
}
},
"Code": 200,
"Message": "Ok"
}