Struct TagsHandler

pub struct TagsHandler<'a> { /* private fields */ }

Handler for tag-related API endpoints (followed and featured tags).

Implementations

impl<'a> TagsHandler<'a>

pub fn new(client: &'a MastodonClient) -> Self

Creates a new TagsHandler for the given client.

pub async fn list_followed(&self) -> Result<Vec<Tag>>

Fetches all tags that the authenticated user is following.

Returns:

• Result<Vec<Tag>>: The followed tags.

Corresponds to GET /api/v1/followed_tags.

pub async fn follow(&self, name: &str) -> Result<Tag>

Follows a tag.

Parameters:

• name: The name of the tag to follow.

Returns:

• Result<Tag>: The followed tag.

Corresponds to POST /api/v1/tags/:name/follow.

pub async fn unfollow(&self, name: &str) -> Result<Tag>

Unfollows a tag.

Parameters:

• name: The name of the tag to unfollow.

Returns:

• Result<Tag>: The unfollowed tag.

Corresponds to POST /api/v1/tags/{name}/unfollow.

pub async fn list_featured(&self) -> Result<Vec<FeaturedTag>>

Fetches all tags featured on the authenticated user’s profile.

Returns:

• Result<Vec<FeaturedTag>>: The featured tags.

Corresponds to GET /api/v1/featured_tags.

pub async fn feature(&self, name: &str) -> Result<FeaturedTag>

Features a tag on the authenticated user’s profile.

Parameters:

• name: The name of the tag to feature.

Returns:

• Result<FeaturedTag>: The featured tag.

Corresponds to POST /api/v1/featured_tags.

pub async fn unfeature(&self, id: &str) -> Result<()>

Unfeatures a tag from the profile.

Parameters:

• id: The ID of the featured tag.

Returns:

• Result<()>: Success if the tag was unfeatured.

Corresponds to DELETE /api/v1/featured_tags/:id.

pub async fn featured_suggestions(&self) -> Result<Vec<Tag>>

Fetches suggestions for tags to feature.

Returns:

• Result<Vec<Tag>>: The suggested tags.

Corresponds to GET /api/v1/featured_tags/suggestions.