rvk

A crate for accessing VK (VKontakte) API in Rust (asynchronously).

The version of VK API that is used by this crate can be found here. Changelog is available here.

Modules

• api - works with the API;
• error - handles errors that may occur during an API call;
• methods - contains API methods;
• objects - contains API objects. See also note about objects.

Usage

Add the dependency to your project:

_Cargo.toml

[dependencies]
rvk = "0.20"

Now you can take a look at rvk's API documentation to learn more about the available functions.

Example

To use this example, you will also need the tokio crate for the tokio::main attribute proc macro.

_Cargo.toml

[dependencies]
tokio = { version = "1.0", features = ["full"] }

_main.rs

use rvk::{methods::users, objects::user::User, APIClient, Params};

#[tokio::main]
async fn main() {
    let api = APIClient::new("your_access_token"); // Create an API Client

    let mut params = Params::new(); // Create a HashMap to store parameters
    params.insert("user_ids".into(), "1".into());

    let res = users::get::<Vec<User>>(&api, params).await;

    match res {
        Ok(users) => {
            let user: &User = &users[0];

            println!(
                "User #{} is {} {}.",
                user.id, user.first_name, user.last_name
            );
        }
        Err(e) => println!("{}", e),
    };
}

Notes

Objects

Due to the nature of the VK API documentation, it is not always clear if the value is always passed or not, and sometimes the data type is not defined.

If you spot any mistakes or bugs, please report them!