Response [200 Ok]

Uri /api/v2/album/nrpkxh?_shorturis=
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] - Cork Heritage Open Day - 19/08/2017
/api/v2/album/nrpkxh

Uri /api/v2/album/nrpkxh
UriDescription Album by key
ResponseLevel Public
AlbumKey nrpkxh
AllowDownloads false
CanShare false
Description Images from some of the buildings in Cork city, Ireland, open to the public on Heritage Day,
External true
HasDownloadPassword false
ImageCount 14
ImagesLastUpdated 2017-08-26T22:39:28+00:00
Keywords Cork Heritage Open Day; Ireland; East Cork Camera Group
LastUpdated 2017-08-26T22:38:32+00:00
Name Cork Heritage Open Day - 19/08/2017
NiceName Cork-Heritage-Open-Day
NodeID QCm9NZ
PasswordHint empty string
Protected true
SecurityType None
SortDirection Ascending
SortMethod Position
Title Cork Heritage Open Day - 19/08/2017
UrlName Cork-Heritage-Open-Day
UrlPath /Shoots/ECCG-Shoots-2017/Cork-Heritage-Open-Day
WebUri http://www.eastcorkcameragroup.ie/Shoots/ECCG-Shoots-2017/Cork-Heritage-Open-Day

Uris

AlbumGeoMedia /api/v2/album/nrpkxh!geomedia
AlbumHighlightImage /api/v2/album/nrpkxh!highlightimage
AlbumImages /api/v2/album/nrpkxh!images
AlbumPopularMedia /api/v2/album/nrpkxh!popularmedia
AlbumPrices /api/v2/album/nrpkxh!prices
AlbumShareUris /api/v2/album/nrpkxh!shareuris
Folder /api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2017
HighlightImage /api/v2/highlight/node/QCm9NZ
Node /api/v2/node/QCm9NZ
NodeCoverImage /api/v2/node/QCm9NZ!cover
ParentFolders /api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2017!parents
User /api/v2/user/eastcorkcameragroup

Timing

Total

cycles 1
objects 0
time 0.03045

Request

Uri /api/v2/album/nrpkxh?_shorturis=
Method GET
Version v2

Options

Path

  • /api
  • /v2
  • /album
  • /

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
  • Read

GET

Permissions
  • Read

PATCH

Permissions
  • Modify

DELETE

Permissions
  • Modify

Output Fields

AlbumKey text
AllowDownloads boolean
Backprinting text
BoutiquePackaging select
  • No
  • Yes
  • Inherit from User
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
  • Custom
  • SmugMug
 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
  • No
  • Yes
  • Inherit from User
 Personal Delivery
Keywords text
LargestSize select
  • Medium
  • Large
  • XLarge
  • X2Large
  • X3Large
  • X4Large
  • X5Large
  • 4K
  • 5K
  • Original
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
  • Public
  • Unlisted
  • Private
 "Private" is not supported on legacy accounts
ProofDays integer
Protected boolean Right-Click Protection
SecurityType select
  • None
  • Password
  • GrantAccess
Share boolean
Slideshow boolean
SmugSearchable select
  • No
  • Inherit from User
SortDirection select
  • Ascending
  • Descending
SortMethod select
  • Position
  • Caption
  • Filename
  • Date Uploaded
  • Date Modified
  • Date Taken
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/nrpkxh?_shorturis="
    },
    "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": "nrpkxh"
            }
        ]
    },
    "Response": {
        "Uri": "/api/v2/album/nrpkxh?_shorturis=",
        "Locator": "Album",
        "LocatorType": "Object",
        "Album": {
            "NiceName": "Cork-Heritage-Open-Day",
            "UrlName": "Cork-Heritage-Open-Day",
            "Title": "Cork Heritage Open Day - 19/08/2017",
            "Name": "Cork Heritage Open Day - 19/08/2017",
            "AllowDownloads": false,
            "Description": "Images from some of the buildings in Cork city, Ireland, open to the public on Heritage Day,",
            "External": true,
            "Keywords": "Cork Heritage Open Day; Ireland; East Cork Camera Group",
            "PasswordHint": "",
            "Protected": true,
            "SortDirection": "Ascending",
            "SortMethod": "Position",
            "SecurityType": "None",
            "AlbumKey": "nrpkxh",
            "LastUpdated": "2017-08-26T22:38:32+00:00",
            "ImagesLastUpdated": "2017-08-26T22:39:28+00:00",
            "NodeID": "QCm9NZ",
            "ImageCount": 14,
            "UrlPath": "/Shoots/ECCG-Shoots-2017/Cork-Heritage-Open-Day",
            "CanShare": false,
            "HasDownloadPassword": false,
            "Uri": "/api/v2/album/nrpkxh",
            "WebUri": "http://www.eastcorkcameragroup.ie/Shoots/ECCG-Shoots-2017/Cork-Heritage-Open-Day",
            "UriDescription": "Album by key",
            "Uris": {
                "AlbumShareUris": "/api/v2/album/nrpkxh!shareuris",
                "Node": "/api/v2/node/QCm9NZ",
                "NodeCoverImage": "/api/v2/node/QCm9NZ!cover",
                "User": "/api/v2/user/eastcorkcameragroup",
                "Folder": "/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2017",
                "ParentFolders": "/api/v2/folder/user/eastcorkcameragroup/Shoots/ECCG-Shoots-2017!parents",
                "HighlightImage": "/api/v2/highlight/node/QCm9NZ",
                "AlbumHighlightImage": "/api/v2/album/nrpkxh!highlightimage",
                "AlbumImages": "/api/v2/album/nrpkxh!images",
                "AlbumPopularMedia": "/api/v2/album/nrpkxh!popularmedia",
                "AlbumGeoMedia": "/api/v2/album/nrpkxh!geomedia",
                "AlbumPrices": "/api/v2/album/nrpkxh!prices"
            },
            "ResponseLevel": "Public"
        },
        "UriDescription": "Album by key",
        "EndpointType": "Album",
        "DocUri": "https://api.smugmug.com/api/v2/doc/reference/album.html",
        "Timing": {
            "Total": {
                "time": 0.03045,
                "cycles": 1,
                "objects": 0
            }
        }
    },
    "Code": 200,
    "Message": "Ok"
}

Contents

  1. Response
  2. Request
  3. Options
    1. Notes
    2. Available Response Levels
    3. Methods
    4. Available Media Types
    5. Output Fields
  4. JSON