A high performance interface for the Roblox API.
This library is designed to be high-performance capable, meaning that it supports proxies and is capable of making requests in parallel.
Note that this crate is still in early development and updates may be breaking until the first major version is released.
Extensive documentation is used throughout this crate. All public methods in this crate are documented and have at least one corresponding example.
Documentation can be found here.
- Auth API - [
auth.roblox.com/*]- Force Refresh X-CSRF-TOKEN -
Client::force_refresh_xcsrf_token
- Force Refresh X-CSRF-TOKEN -
- BEDEV2 API - [
apis.roblox.com/*]- Fetch Non-Tradable Limited Details -
Client::non_tradable_limited_details - Fetch Collectible Product ID -
Client::collectible_product_id - Fetch Collectible Product ID Bulk -
Client::collectible_product_id_bulk - Fetch Collectible Creator ID -
Client::collectible_creator_id - Purchase Non-Tradable Limited -
Client::purchase_non_tradable_limited
- Fetch Non-Tradable Limited Details -
- Catalog API - [
catalog.roblox.com/*]- Fetch Item Details -
Client::item_details - Fetch Product ID -
Client::product_id - Fetch Product ID Bulk -
Client::product_id_bulk - Fetch Collectible Item ID -
Client::collectible_item_id - Fetch Collectible Item ID Bulk -
Client::collectible_item_id_bulk - Avatar Catalog Search -
Client::avatar_catalog_search
- Fetch Item Details -
- Chat API - [
chat.roblox.com/*]- Fetch Unread Conversation Count -
Client::unread_conversation_count
- Fetch Unread Conversation Count -
- Economy API - [
economy.roblox.com/*]- Fetch Robux Balance -
Client::robux - Fetch Resellers -
Client::resellers - Fetch User Sales -
Client::user_sales - Put Limited On Sale -
Client::put_limited_on_sale - Take Limited Off Sale -
Client::take_limited_off_sale - Purchase Tradable Limited -
Client::purchase_tradable_limited
- Fetch Robux Balance -
- Group API - [
groups.roblox.com/*]- Fetch Group Roles -
Client::group_roles - Fetch Group Role Members -
Client::group_role_members - Set Group Member Role -
Client::set_group_member_role
- Fetch Group Roles -
- Presence API - [
presence.roblox.com/*]- Register Presence -
Client::register_presence
- Register Presence -
- Private Messages API - [
privatemessages.roblox.com/*]- Fetch Messages -
Client::messages
- Fetch Messages -
- Thumbnails API - [
thumbnails.roblox.com/*]- Fetch Thumbnail Url Bulk -
Client::thumbnail_url_bulk - Fetch Thumbnail Url -
Client::thumbnail_url
- Fetch Thumbnail Url Bulk -
- Trades API - [
trades.roblox.com/*]- Accept Trade -
Client::accept_trade - Decline Trade -
Client::decline_trade - Send Trade -
Client::send_trade - Fetch Trades List -
Client::trades - Fetch Trade Details -
Client::trade_details - Fetch Trade Count -
Client::trade_count
- Accept Trade -
- Users API - [
users.roblox.com/*]- Fetch User ID -
Client::user_id - Fetch Username -
Client::username - Fetch Display Name -
Client::display_name - User Search -
Client::user_search - Fetch User Details -
Client::user_details
- Fetch User ID -
You can add the latest version of roboat to your project by running:
cargo add roboatThis code snippet allows you to purchase a free ugc limited.
It can be modified to purchase a non-free ugc limited by changing the price.
// Replace this value with your own roblosecurity token.
const ROBLOSECURITY: &str = "your-roblosecurity-token";
// Replace this value with the item id of the item you want to purchase.
const ITEM_ID: u64 = 13119979433;
// Replace this value if you want to purchase a non-free item.
const PRICE: u64 = 0;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = roboat::ClientBuilder::new()
.roblosecurity(ROBLOSECURITY.to_string())
.build();
let collectible_item_id = client.collectible_item_id(ITEM_ID).await?;
let collectible_product_id = client
.collectible_product_id(collectible_item_id.clone())
.await?;
let collectible_creator_id = client
.collectible_creator_id(collectible_item_id.clone())
.await?;
client
.purchase_non_tradable_limited(
collectible_item_id,
collectible_product_id,
collectible_creator_id,
PRICE,
)
.await?;
println!("Purchased item {} for {} robux!", ITEM_ID, PRICE);
Ok(())
}This code snippet allows you to get your current robux, id, username, and display name.
// Replace this value with your own roblosecurity token.
const ROBLOSECURITY: &str = "your-roblosecurity-token";
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = roboat::ClientBuilder::new()
.roblosecurity(ROBLOSECURITY.to_string())
.build();
let robux = client.robux().await?;
let user_id = client.user_id().await?;
let username = client.username().await?;
let display_name = client.display_name().await?;
println!("Robux: {}", robux);
println!("User ID: {}", user_id);
println!("Username: {}", username);
println!("Display Name: {}", display_name);
Ok(())
}This code snippet allows you to view the lowest price of a tradable limited item by fetching a list of reseller listings.
// Replace this value with your own roblosecurity token.
const ROBLOSECURITY: &str = "your-roblosecurity-token";
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = roboat::ClientBuilder::new()
.roblosecurity(ROBLOSECURITY.to_string())
.build();
let item_id = 1365767;
let limit = roboat::Limit::Ten;
let cursor = None;
let (resellers, _) = client.resellers(item_id, limit, cursor).await?;
println!("Lowest Price for Valkyrie Helm: {}", resellers[0].price);
Ok(())
}This code snippet allows you to get the details of an item.
use roboat::catalog::avatar_catalog::{ItemArgs, ItemType};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = roboat::ClientBuilder::new().build();
let item = ItemArgs {
item_type: ItemType::Asset,
id: 1365767,
};
let details = &client.item_details(vec![item]).await?[0];
let name = &details.name;
let description = &details.description;
let creator_name = &details.creator_name;
let price = details.price.unwrap_or(0);
println!("Name: {}", name);
println!("Description: {}", description);
println!("Creator Name: {}", creator_name);
println!("Price: {}", price);
Ok(())
}More examples can be found in the examples directory.
This crate is a sister crate of roli, an API wrapper for Rolimons.com.
Pull requests and issues are welcome!
Please refer to CONVENTIONS.md for information on conventions used in this crate.
Additional resources used to help make this crate are available in RESOURCES.md.
MIT License
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent