Response [200 Ok]
| Uri | /api/v2/album/Rjjjx9 |
|---|---|
| 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]
- World Wide Photo Walk - 01/10/2016
/api/v2/album/Rjjjx9
| Uri | /api/v2/album/Rjjjx9 |
|---|---|
| UriDescription | Album by key |
| ResponseLevel | Public |
| AlbumKey | Rjjjx9 |
| AllowDownloads | false |
| CanShare | true |
| Description | Images from ECCG's photowalk in Cobh, Co. Cork - part of the Scott Kelby World Wide Photo Walk 2016 |
| External | true |
| HasDownloadPassword | false |
| ImageCount | 123 |
| ImagesLastUpdated | 2016-11-02T17:44:07+00:00 |
| Keywords | Scott Kelby; Worldwide Photo Walk; Cobh; Cork; Ireland; East Cork Camera Group |
| LastUpdated | 2016-10-17T18:13:48+00:00 |
| Name | World Wide Photo Walk - 01/10/2016 |
| NiceName | World-Wide-Photo-Walk-01102016 |
| NodeID | t33F87 |
| PasswordHint | empty string |
| Protected | true |
| SecurityType | None |
| SortDirection | Ascending |
| SortMethod | Position |
| Title | World Wide Photo Walk - 01/10/2016 |
| UrlName | World-Wide-Photo-Walk-01102016 |
| UrlPath | /Shoots/ECCG-Shoots-2016/World-Wide-Photo-Walk-01102016 |
| WebUri | http://www.eastcorkcameragroup.ie/Shoots/ECCG-Shoots-2016/World-Wide-Photo-Walk-01102016 |
Uris
AlbumGeoMedia
/api/v2/album/Rjjjx9!geomedia
| Uri | /api/v2/album/Rjjjx9!geomedia |
|---|---|
| UriDescription | Geotagged images from album |
| EndpointType | AlbumGeoMedia |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumHighlightImage
/api/v2/album/Rjjjx9!highlightimage
| Uri | /api/v2/album/Rjjjx9!highlightimage |
|---|---|
| UriDescription | Highlight image for album |
| EndpointType | AlbumHighlightImage |
| Locator | AlbumImage |
| LocatorType | Object |
AlbumImages
/api/v2/album/Rjjjx9!images
| Uri | /api/v2/album/Rjjjx9!images |
|---|---|
| UriDescription | Images from album |
| EndpointType | AlbumImages |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumPopularMedia
/api/v2/album/Rjjjx9!popularmedia
| Uri | /api/v2/album/Rjjjx9!popularmedia |
|---|---|
| UriDescription | Popular images from album |
| EndpointType | AlbumPopularMedia |
| Locator | AlbumImage |
| LocatorType | Objects |
AlbumPrices
/api/v2/album/Rjjjx9!prices
| Uri | /api/v2/album/Rjjjx9!prices |
|---|---|
| UriDescription | Purchasable Skus |
| EndpointType | AlbumPrices |
| Locator | CatalogSkuPrice |
| LocatorType | Objects |
AlbumShareUris
/api/v2/album/Rjjjx9!shareuris
| Uri | /api/v2/album/Rjjjx9!shareuris |
|---|---|
| UriDescription | URIs that are useful for sharing |
| EndpointType | AlbumShareUris |
| Locator | AlbumShareUris |
| LocatorType | Object |
Folder
/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016
| Uri | /api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016 |
|---|---|
| UriDescription | A folder or legacy (sub)category by UrlPath |
| EndpointType | Folder |
| Locator | Folder |
| LocatorType | Object |
HighlightImage
/api/v2/highlight/node/t33F87
| Uri | /api/v2/highlight/node/t33F87 |
|---|---|
| UriDescription | Highlight image for a folder, album, or page |
| EndpointType | HighlightImage |
| Locator | Image |
| LocatorType | Object |
Node
/api/v2/node/t33F87
| Uri | /api/v2/node/t33F87 |
|---|---|
| UriDescription | Node with the given id. |
| EndpointType | Node |
| Locator | Node |
| LocatorType | Object |
NodeCoverImage
/api/v2/node/t33F87!cover
| Uri | /api/v2/node/t33F87!cover |
|---|---|
| UriDescription | Cover image for a folder, album, or page |
| EndpointType | NodeCoverImage |
| Locator | Image |
| LocatorType | Object |
ParentFolders
/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016!parents
| Uri | /api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016!parents |
|---|---|
| UriDescription | The sequence of parent folders, from the given folder to the root |
| EndpointType | ParentFolders |
| Locator | Folder |
| LocatorType | Objects |
User
/api/v2/user/eastcorkcameragroup
| Uri | /api/v2/user/eastcorkcameragroup |
|---|---|
| UriDescription | User By Nickname |
| EndpointType | User |
| Locator | User |
| LocatorType | Object |
Request
| Uri | /api/v2/album/Rjjjx9 |
|---|---|
| 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
|
|
| CanRank | boolean | |
| CanShare | boolean | Does the owner of this album want it to be shareable? |
| Clean | boolean | |
| Comments | boolean | |
| Date | datetime | |
| Description | text | |
| DownloadPassword | text | |
| EXIF | boolean | |
| External | Deprecated as of 2015-09-08 | An old setting that no longer has any function |
| FamilyEdit | boolean | |
| Filenames | boolean | |
| FriendEdit | boolean | |
| Geography | boolean | |
| HasDownloadPassword | boolean | |
| Header |
select
|
Appearance |
| HideOwner | boolean | |
| HighlightAlbumImageUri | uri | |
| ImageCount | integer | |
| ImagesLastUpdated | timestamp | The last time at which images were added, removed, or rearranged in this album |
| InterceptShipping |
select
|
Personal Delivery |
| Keywords | text | |
| LargestSize |
select
|
|
| LastUpdated | datetime | |
| Name | text | |
| NiceName | Deprecated as of 2014-11-20 | Use UrlName instead |
| NodeID | text | |
| OriginalSizes | integer | |
| 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/Rjjjx9"
},
"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": "HighlightAlbumImageUri",
"Type": "Uri",
"MAX_LENGTH": "INFINITY",
"Locator": [
"AlbumImage"
]
},
{
"Name": "AlbumKey",
"Type": "Varchar",
"MIN_CHARS": 0,
"MAX_CHARS": "INFINITY"
},
{
"Name": "Date",
"Type": "DateTime"
},
{
"Name": "LastUpdated",
"Type": "DateTime"
},
{
"Name": "ImagesLastUpdated",
"Description": "The last time at which images were added, removed, or rearranged in this album",
"Type": "Timestamp"
},
{
"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"
}
],
"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": "Rjjjx9"
}
]
},
"Response": {
"Uri": "/api/v2/album/Rjjjx9",
"Locator": "Album",
"LocatorType": "Object",
"Album": {
"NiceName": "World-Wide-Photo-Walk-01102016",
"UrlName": "World-Wide-Photo-Walk-01102016",
"Title": "World Wide Photo Walk - 01/10/2016",
"Name": "World Wide Photo Walk - 01/10/2016",
"AllowDownloads": false,
"Description": "Images from ECCG's photowalk in Cobh, Co. Cork - part of the Scott Kelby World Wide Photo Walk 2016",
"External": true,
"Keywords": "Scott Kelby; Worldwide Photo Walk; Cobh; Cork; Ireland; East Cork Camera Group",
"PasswordHint": "",
"Protected": true,
"SortDirection": "Ascending",
"SortMethod": "Position",
"SecurityType": "None",
"AlbumKey": "Rjjjx9",
"LastUpdated": "2016-10-17T18:13:48+00:00",
"ImagesLastUpdated": "2016-11-02T17:44:07+00:00",
"NodeID": "t33F87",
"ImageCount": 123,
"UrlPath": "/Shoots/ECCG-Shoots-2016/World-Wide-Photo-Walk-01102016",
"CanShare": true,
"HasDownloadPassword": false,
"Uri": "/api/v2/album/Rjjjx9",
"WebUri": "http://www.eastcorkcameragroup.ie/Shoots/ECCG-Shoots-2016/World-Wide-Photo-Walk-01102016",
"UriDescription": "Album by key",
"Uris": {
"AlbumShareUris": {
"Uri": "/api/v2/album/Rjjjx9!shareuris",
"Locator": "AlbumShareUris",
"LocatorType": "Object",
"UriDescription": "URIs that are useful for sharing",
"EndpointType": "AlbumShareUris"
},
"Node": {
"Uri": "/api/v2/node/t33F87",
"Locator": "Node",
"LocatorType": "Object",
"UriDescription": "Node with the given id.",
"EndpointType": "Node"
},
"NodeCoverImage": {
"Uri": "/api/v2/node/t33F87!cover",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Cover image for a folder, album, or page",
"EndpointType": "NodeCoverImage"
},
"User": {
"Uri": "/api/v2/user/eastcorkcameragroup",
"Locator": "User",
"LocatorType": "Object",
"UriDescription": "User By Nickname",
"EndpointType": "User"
},
"Folder": {
"Uri": "/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016",
"Locator": "Folder",
"LocatorType": "Object",
"UriDescription": "A folder or legacy (sub)category by UrlPath",
"EndpointType": "Folder"
},
"ParentFolders": {
"Uri": "/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2016!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/t33F87",
"Locator": "Image",
"LocatorType": "Object",
"UriDescription": "Highlight image for a folder, album, or page",
"EndpointType": "HighlightImage"
},
"AlbumHighlightImage": {
"Uri": "/api/v2/album/Rjjjx9!highlightimage",
"Locator": "AlbumImage",
"LocatorType": "Object",
"UriDescription": "Highlight image for album",
"EndpointType": "AlbumHighlightImage"
},
"AlbumImages": {
"Uri": "/api/v2/album/Rjjjx9!images",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Images from album",
"EndpointType": "AlbumImages"
},
"AlbumPopularMedia": {
"Uri": "/api/v2/album/Rjjjx9!popularmedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Popular images from album",
"EndpointType": "AlbumPopularMedia"
},
"AlbumGeoMedia": {
"Uri": "/api/v2/album/Rjjjx9!geomedia",
"Locator": "AlbumImage",
"LocatorType": "Objects",
"UriDescription": "Geotagged images from album",
"EndpointType": "AlbumGeoMedia"
},
"AlbumPrices": {
"Uri": "/api/v2/album/Rjjjx9!prices",
"Locator": "CatalogSkuPrice",
"LocatorType": "Objects",
"UriDescription": "Purchasable Skus",
"EndpointType": "AlbumPrices"
}
},
"ResponseLevel": "Public"
},
"UriDescription": "Album by key",
"EndpointType": "Album",
"DocUri": "https://api.smugmug.com/api/v2/doc/reference/album.html",
"Timing": {
"Total": {
"time": 0.03627,
"cycles": 1,
"objects": 0
}
}
},
"Code": 200,
"Message": "Ok"
}