Struct SmugMugClient 

pub struct SmugMugClient { /* private fields */ }

Implementations

impl SmugMugClient

pub async fn list_albums(&self) -> Result<Vec<Album>>

pub async fn create_album( &self, name: &str, parent_node_uri: Option<&str>, privacy: &str, ) -> Result<Album>

pub async fn find_album_in_folder( &self, parent_node_uri: &str, album_name: &str, ) -> Result<Option<Album>>

pub async fn find_or_create_folder_path( &self, folder_path: &str, privacy: Option<&str>, ) -> Result<String>

Find or create each folder along folder_path (e.g. “2024/Travel”) and return the last one’s node URI. privacy (Public, Unlisted or Private) is set on any folder that has to be created; None leaves SmugMug’s default. Existing folders are left as they are.

pub async fn find_folder_path( &self, folder_path: &str, ) -> Result<Option<String>>

Node URI of the folder at folder_path, or None if any folder along it doesn’t exist. Creates nothing.

pub async fn get_album(&self, album_key: &str) -> Result<Album>

pub async fn delete_album(&self, album_key: &str) -> Result<()>

pub async fn get_node_tree(&self) -> Result<NodeTree>

pub async fn update_album_settings( &self, album_key: &str, settings: AlbumSettingsUpdate, ) -> Result<()>

pub async fn request_album_download( &self, album_key: &str, ) -> Result<AlbumDownloadInfo>

Request album download ZIP generation

pub async fn check_album_download_status( &self, download_uri: &str, ) -> Result<AlbumDownloadInfo>

Check the status of an album download

pub async fn get_album_download_link(&self, album_key: &str) -> Result<String>

Get album download link with polling (max 10 attempts, 3s intervals)

impl SmugMugClient

pub async fn list_image_comments(&self, image_key: &str) -> Result<Vec<Comment>>

List all comments for an image

pub async fn create_image_comment( &self, image_key: &str, request: CreateCommentRequest, ) -> Result<Comment>

Create a new comment on an image

impl SmugMugClient

pub async fn list_album_images( &self, album_key: &str, ) -> Result<Vec<AlbumImage>>

Every image in the album, across all pages of the listing.

pub async fn get_image_details(&self, image_key: &str) -> Result<ImageDetails>

pub async fn delete_image(&self, image_key: &str) -> Result<()>

pub async fn update_image_metadata( &self, image_key: &str, metadata: ImageMetadataUpdate, ) -> Result<()>

pub async fn move_image( &self, image_key: &str, target_album_key: &str, ) -> Result<()>

impl SmugMugClient

pub fn new( api_key: String, api_secret: String, access_token: String, access_token_secret: String, ) -> Self

pub fn build_oauth_header(&self, method: &str, url: &str) -> String

pub fn build_oauth_header_with_query<T: Request>( &self, method: &str, url: &str, query: &T, ) -> String

Same as build_oauth_header, but for a request that carries query parameters (e.g. pagination’s start/count). OAuth1 signing requires those parameters to be passed in separately rather than embedded in url — a url containing a ?query part panics inside the oauth1-request crate. Callers must send the request with the same query value (e.g. reqwest’s .query(query)) so the signed parameters match what is actually sent.

pub async fn get_auth_user(&self) -> Result<Value>

pub async fn get_user_features(&self, user_uri: &str) -> Result<Value>

pub async fn request_raw( &self, method: &str, path_or_url: &str, ) -> Result<(u16, String)>

Authenticated request with any HTTP method to an arbitrary API path (e.g. /api/v2!authuser?_verbosity=1) or absolute URL, returning the HTTP status and raw body without interpreting either. Query parameters are signed separately, as OAuth1 requires. Used for exploring endpoints that aren’t publicly documented; OPTIONS makes SmugMug describe an endpoint’s methods and parameters.

pub async fn get_all_pages<T: DeserializeOwned>( &self, first_url: &str, locator: &str, ) -> Result<Vec<T>>

GET a SmugMug list endpoint (e.g. .../album/KEY!images) and every following page, returning all items of the locator array (e.g. “AlbumImage”, “Album”, “Comment”, “Node”) from each page’s Response. SmugMug returns one page per request (often 100 items, sometimes fewer) and links the next one as Response.Pages.NextPage; a missing locator array (empty list) yields no items. Later pages are fetched from the same host as first_url, with their query parameters signed separately as OAuth1 requires.

pub async fn get_with_auth(&self, url: &str) -> Result<Response>

pub async fn post_with_auth(&self, url: &str, body: Value) -> Result<Response>

pub async fn delete_with_auth(&self, url: &str) -> Result<Response>

pub async fn patch_with_auth(&self, url: &str, body: Value) -> Result<Response>