Response [200 Ok]
| Uri | /api/v2/album/T89LKX |
|---|---|
| UriDescription | Album by key |
| DocUri | https://api.smugmug.com/api/v2/doc/reference/album.html |
| EndpointType | Album |
| Locator | Album |
| LocatorType | Object |
Album [1 of 1]
- Driving
/api/v2/album/T89LKX
| Uri | /api/v2/album/T89LKX |
|---|---|
| UriDescription | Album by key |
| ResponseLevel | Public |
| AlbumKey | T89LKX |
| AllowDownloads | true |
| CanBuy | true |
| CanFavorite | false |
| CanShare | false |
| CommerceLightbox | false |
| Description | We've had the Sacco dog cart for several years, and our two Borzoi teams have logged over 1000 miles in harness in the winter months. Information about the dogs and driving can be found at our kennel website: http://www.sylvanborzoi.com/driving/driving.html |
| EXIF | true |
| External | true |
| Filenames | true |
| Geography | true |
| HasDownloadPassword | false |
| ImageCount | 46 |
| ImagesLastUpdated | 2016-12-10T15:52:50+00:00 |
| Keywords | empty string |
| LastUpdated | 2006-12-06T00:45:58+00:00 |
| Name | Driving |
| NiceName | Driving |
| NodeID | GKW2b |
| Packages | false |
| PasswordHint | empty string |
| Protected | false |
| SecurityType | None |
| SortDirection | Ascending |
| SortMethod | Position |
| Title | Driving |
| UrlName | Driving |
| UrlPath | /Sylvan-Borzoi/Driving |
| WebUri | https://zoisrus.smugmug.com/Sylvan-Borzoi/Driving |
Uris
AlbumComments
/api/v2/album/T89LKX!comments
| Uri | /api/v2/album/T89LKX!comments |
|---|---|
| UriDescription | Comments on album |
| EndpointType | AlbumComments |
| Locator | Comment |
| LocatorType | Objects |
AlbumDownload
/api/v2/album/T89LKX!download
| Uri | /api/v2/album/T89LKX!download |
|---|---|
| UriDescription | Download album |
| EndpointType | AlbumDownload |
| Locator | Download |
| LocatorType | Objects |
AlbumGeoMedia
/api/v2/album/T89LKX!geomedia
| Uri | /api/v2/album/T89LKX!geomedia |
|---|---|
| UriDescription | Geotagged images from album |
| EndpointType | AlbumGeoMedia |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumHighlightImage
/api/v2/album/T89LKX!highlightimage
| Uri | /api/v2/album/T89LKX!highlightimage |
|---|---|
| UriDescription | Highlight image for album |
| EndpointType | AlbumHighlightImage |
| Locator | AlbumImage |
| LocatorType | Object |
AlbumImages
/api/v2/album/T89LKX!images
| Uri | /api/v2/album/T89LKX!images |
|---|---|
| UriDescription | Images from album |
| EndpointType | AlbumImages |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumPopularMedia
/api/v2/album/T89LKX!popularmedia
| Uri | /api/v2/album/T89LKX!popularmedia |
|---|---|
| UriDescription | Popular images from album |
| EndpointType | AlbumPopularMedia |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumPricelistExclusions
/api/v2/album/T89LKX!pricelistexclusions
| Uri | /api/v2/album/T89LKX!pricelistexclusions |
|---|---|
| UriDescription | Pricelist information for an Album |
| EndpointType | AlbumPricelistExclusions |
| Locator | AlbumPricelistExclusions |
| LocatorType | Object |
AlbumPrices
/api/v2/album/T89LKX!prices
| Uri | /api/v2/album/T89LKX!prices |
|---|---|
| UriDescription | Purchasable Skus |
| EndpointType | AlbumPrices |
| Locator | CatalogSkuPrice |
| LocatorType | Objects |
AlbumShareUris
/api/v2/album/T89LKX!shareuris
| Uri | /api/v2/album/T89LKX!shareuris |
|---|---|
| UriDescription | URIs that are useful for sharing |
| EndpointType | AlbumShareUris |
| Locator | AlbumShareUris |
| LocatorType | Object |
Folder
/api/v2/folder/user/zoisrus/Sylvan-Borzoi
| Uri | /api/v2/folder/user/zoisrus/Sylvan-Borzoi |
|---|---|
| UriDescription | A folder or legacy (sub)category by UrlPath |
| EndpointType | Folder |
| Locator | Folder |
| LocatorType | Object |
HighlightImage
/api/v2/highlight/node/GKW2b
| Uri | /api/v2/highlight/node/GKW2b |
|---|---|
| UriDescription | Highlight image for a folder, album, or page |
| EndpointType | HighlightImage |
| Locator | Image |
| LocatorType | Object |
Node
/api/v2/node/GKW2b
| Uri | /api/v2/node/GKW2b |
|---|---|
| UriDescription | Node with the given id. |
| EndpointType | Node |
| Locator | Node |
| LocatorType | Object |
NodeCoverImage
/api/v2/node/GKW2b!cover
| Uri | /api/v2/node/GKW2b!cover |
|---|---|
| UriDescription | Cover image for a folder, album, or page |
| EndpointType | NodeCoverImage |
| Locator | Image |
| LocatorType | Object |
ParentFolders
/api/v2/folder/user/zoisrus/Sylvan-Borzoi!parents
| Uri | /api/v2/folder/user/zoisrus/Sylvan-Borzoi!parents |
|---|---|
| UriDescription | The sequence of parent folders, from the given folder to the root |
| EndpointType | ParentFolders |
| Locator | Folder |
| LocatorType | Objects |
User
/api/v2/user/zoisrus
| Uri | /api/v2/user/zoisrus |
|---|---|
| UriDescription | User By Nickname |
| EndpointType | User |
| Locator | User |
| LocatorType | Object |
Request
| Uri | /api/v2/album/T89LKX |
|---|---|
| Method | GET |
| Version | v2 |
Options
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
Methods
OPTIONS
| Permissions |
|
|---|
GET
| Permissions |
|
|---|
PATCH
| Permissions |
|
|---|
DELETE
| Permissions |
|
|---|
Output Fields
| AlbumKey | text | |
|---|---|---|
| AllowDownloads | boolean | |
| Backprinting | text | |
| BoutiquePackaging |
select
|
|
| CanBuy | boolean | |
| CanFavorite | boolean | |
| CanRank | boolean | |
| CanShare | boolean | Does the owner of this album want it to be shareable? |
| Clean | boolean | |
| Comments | boolean | |
| CommerceLightbox | boolean | |
| Date | datetimeiso8601 | |
| Description | text | |
| DownloadPassword | text | |
| EXIF | boolean | |
| External | Deprecated as of 2015-09-08 | An old setting that no longer has any function |
| FamilyEdit | boolean | |
| FavoriteAlbumUrl | fullurl | |
| Filenames | boolean | |
| FriendEdit | boolean | |
| Geography | boolean | |
| HasDownloadPassword | boolean | |
| Header |
select
|
Appearance |
| HideOwner | boolean | |
| HighlightAlbumImageUri | uri | |
| ImageCount | integer | |
| ImagesLastUpdated | datetimeiso8601 | The last time at which images were added, removed, or rearranged in this album |
| InterceptShipping |
select
|
Personal Delivery |
| Keywords | text | |
| LargestSize |
select
|
|
| LastUpdated | datetimeiso8601 | |
| Name | text | |
| NiceName | Deprecated as of 2014-11-20 | Use UrlName instead |
| NodeID | text | |
| OriginalSizes | integer | |
| Packages | boolean | Are any packages available for album |
| PackagingBranding | boolean | |
| Password | text | |
| PasswordHint | text | |
| Printable | boolean | |
| PrintmarkUri | uri | |
| Privacy |
select
|
"Private" is not supported on legacy accounts |
| ProofDays | integer | |
| Protected | boolean | Right-Click Protection |
| SecurityType |
select
|
|
| Share | boolean | |
| Slideshow | boolean | |
| SmugSearchable |
select
|
|
| SortDirection |
select
|
|
| SortMethod |
select
|
|
| SquareThumbs | boolean | |
| TemplateUri | uri | |
| ThemeUri | uri | Only applies to legacy accounts |
| Title | Deprecated as of 2014-11-20 | Use Name instead |
| TotalSizes | integer | |
| UploadKey | text | Guest UploadKey |
| UrlName | text | A human-readable name for use in the URL |
| UrlPath | text | |
| Watermark | boolean | Automatically apply watermark to uploaded images? |
| WatermarkUri | uri | |
| WorldSearchable | boolean |
JSON
{
"Request": {
"Version": "v2",
"Method": "GET",
"Uri": "/api/v2/album/T89LKX"
},
"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": "ALL"
},
{
"Name": "CommerceLightbox",
"Type": "Boolean"
},
{
"Name": "HighlightAlbumImageUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"AlbumImage"
]
},
{
"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": "T89LKX"
}
]
},
"Response": {
"Uri": "/api/v2/album/T89LKX",
"Locator": "Album",
"LocatorType": "Object",
"Album": {
"NiceName": "Driving",
"UrlName": "Driving",
"Title": "Driving",
"Name": "Driving",
"AllowDownloads": true,
"Description": "We've had the Sacco dog cart for several years, and our two Borzoi teams have logged over 1000 miles in harness in the winter months.\r\nInformation about the dogs and driving can be found at our kennel website:\r\nhttp://www.sylvanborzoi.com/driving/driving.html",
"EXIF": true,
"External": true,
"Filenames": true,
"Geography": true,
"Keywords": "",
"PasswordHint": "",
"Protected": false,
"SortDirection": "Ascending",
"SortMethod": "Position",
"SecurityType": "None",
"CommerceLightbox": false,
"AlbumKey": "T89LKX",
"CanBuy": true,
"CanFavorite": false,
"LastUpdated": "2006-12-06T00:45:58+00:00",
"ImagesLastUpdated": "2016-12-10T15:52:50+00:00",
"NodeID": "GKW2b",
"ImageCount": 46,
"UrlPath": "/Sylvan-Borzoi/Driving",
"CanShare": false,
"HasDownloadPassword": false,
"Packages": false,
"Uri": "/api/v2/album/T89LKX",
"WebUri": "https://zoisrus.smugmug.com/Sylvan-Borzoi/Driving",
"UriDescription": "Album by key",
"Uris": {
"AlbumShareUris": {
"Uri": "/api/v2/album/T89LKX!shareuris",
"Locator": "AlbumShareUris",
"LocatorType": "Object",
"UriDescription": "URIs that are useful for sharing",
"EndpointType": "AlbumShareUris"
},
"Node": {
"Uri": "/api/v2/node/GKW2b",
"Locator": "Node",
"LocatorType": "Object",
"UriDescription": "Node with the given id.",
"EndpointType": "Node"
},
"NodeCoverImage": {
"Uri": "/api/v2/node/GKW2b!cover",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Cover image for a folder, album, or page",
"EndpointType": "NodeCoverImage"
},
"User": {
"Uri": "/api/v2/user/zoisrus",
"Locator": "User",
"LocatorType": "Object",
"UriDescription": "User By Nickname",
"EndpointType": "User"
},
"Folder": {
"Uri": "/api/v2/folder/user/zoisrus/Sylvan-Borzoi",
"Locator": "Folder",
"LocatorType": "Object",
"UriDescription": "A folder or legacy (sub)category by UrlPath",
"EndpointType": "Folder"
},
"ParentFolders": {
"Uri": "/api/v2/folder/user/zoisrus/Sylvan-Borzoi!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/GKW2b",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Highlight image for a folder, album, or page",
"EndpointType": "HighlightImage"
},
"AlbumHighlightImage": {
"Uri": "/api/v2/album/T89LKX!highlightimage",
"Locator": "AlbumImage",
"LocatorType": "Object",
"UriDescription": "Highlight image for album",
"EndpointType": "AlbumHighlightImage"
},
"AlbumImages": {
"Uri": "/api/v2/album/T89LKX!images",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Images from album",
"EndpointType": "AlbumImages"
},
"AlbumPopularMedia": {
"Uri": "/api/v2/album/T89LKX!popularmedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Popular images from album",
"EndpointType": "AlbumPopularMedia"
},
"AlbumGeoMedia": {
"Uri": "/api/v2/album/T89LKX!geomedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Geotagged images from album",
"EndpointType": "AlbumGeoMedia"
},
"AlbumComments": {
"Uri": "/api/v2/album/T89LKX!comments",
"Locator": "Comment",
"LocatorType": "Objects",
"UriDescription": "Comments on album",
"EndpointType": "AlbumComments"
},
"AlbumDownload": {
"Uri": "/api/v2/album/T89LKX!download",
"Locator": "Download",
"LocatorType": "Objects",
"UriDescription": "Download album",
"EndpointType": "AlbumDownload"
},
"AlbumPrices": {
"Uri": "/api/v2/album/T89LKX!prices",
"Locator": "CatalogSkuPrice",
"LocatorType": "Objects",
"UriDescription": "Purchasable Skus",
"EndpointType": "AlbumPrices"
},
"AlbumPricelistExclusions": {
"Uri": "/api/v2/album/T89LKX!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.02504,
"cycles": 1,
"objects": 0
}
}
},
"Code": 200,
"Message": "Ok"
}
