Struct UsersApi 

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

Users API - handles all user-related endpoints

Implementations

impl<'a> UsersApi<'a>

pub async fn get(&self, user_ids: Vec<u64>) -> Result<Vec<User>>

Get users by their IDs

If no IDs are provided, returns the authenticated user’s information.

Requires OAuth token with user:read scope

Example

// Get specific users
let users = client.users().get(vec![123, 456]).await?;

// Get current authenticated user
let me = client.users().get_me().await?;

pub async fn get_me(&self) -> Result<User>

Get the currently authenticated user’s information

This is a convenience method that calls get() with no IDs.

Requires OAuth token with user:read scope

Example

let me = client.users().get_me().await?;
println!("Logged in as: {}", me.name);

pub async fn introspect_token(&self) -> Result<TokenIntrospection>

Introspect an OAuth token (validate it)

This validates the token passed in the Authorization header. Implements RFC 7662 OAuth 2.0 Token Introspection.

Note: This endpoint is deprecated but still functional.

Requires OAuth token (no specific scope needed)

Example

let introspection = client.users().introspect_token().await?;

if introspection.is_active() {
    println!("Token is valid!");
    println!("Scopes: {:?}", introspection.scopes());

    if introspection.has_scope("user:read") {
        println!("Has user:read permission");
    }

    if introspection.is_expired() {
        println!("Token is expired!");
    }
} else {
    println!("Token is invalid");
}