Struct Client 

pub struct Client { /* private fields */ }

Client to interact with the Last.fm API.

Use Client::builder() to construct a new client.

Implementations

impl Client

pub async fn get_token(&self) -> Result<String, Error>

Get an authentication token.

This token must be approved by the user before exchanging it for a session.

Last.fm docs

pub async fn get_session(&self, token: &str) -> Result<Session, Error>

Get a session key after the user has approved the token.

This is used to perform authenticated requests on behalf of a user.

Last.fm docs

impl Client

pub fn builder(api_key: impl Into<String>) -> ClientBuilder

Creates a new builder with the mandatory API key.

Example

use std::time::Duration;
use soniq::client::Client;

let client = Client::builder("YOUR_API_KEY")
    .api_secret("YOUR_API_SECRET")
    .timeout(Duration::from_secs(5))
    .build()?;

pub async fn unsigned_get<T: DeserializeOwned>( &self, method: &str, params: BTreeMap<String, String>, ) -> Result<T, Error>

Performs an unsigned GET request to the Last.fm API.

pub async fn signed_post<T: DeserializeOwned>( &self, method: &str, params: BTreeMap<String, String>, ) -> Result<T, Error>

Performs a signed POST request without a user session key.

This is for methods that require a signature but don’t operate on a specific user’s account.

pub async fn signed_post_with_session<T: DeserializeOwned>( &self, method: &str, session_key: Option<&str>, params: BTreeMap<String, String>, ) -> Result<T, Error>

Performs a signed POST request with an optional user session key.

Pass Some(session_key) to authenticate on behalf of a user. This requires the client to have been built with an API secret.

impl Client

pub fn user(&self) -> UserHandler<'_>

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl UserEndpointExt for Client

Implements user() on the client.

fn user(&self) -> UserHandler<'_>