roblox-api 0.1.7

Roblox web api bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use serde::{Deserialize, Serialize};

use crate::{Currency, Error, client::Client};

pub const URL: &str = "https://economy.roblox.com/v1";

#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
pub struct PurchaseResponse {
    pub purchased: bool,
}

/// This api seems to only give an Internal Server Error, try using `marketplace_sales::v1::purchase` instead
pub async fn purchase(
    client: &mut Client,
    product_id: u64,
    price: u64,
    currency: Currency,
    seller_user_id: Option<u64>,
) -> Result<PurchaseResponse, Error> {
    #[derive(Serialize)]
    struct Request {
        #[serde(rename = "expectedCurrency")]
        currency: u8,
        #[serde(rename = "expectedPrice")]
        price: u64,
        #[serde(rename = "expectedSellerId")]
        seller_user_id: Option<u64>,
    }

    let result = client
        .requestor
        .client
        .post(format!("{URL}/purchases/products/{product_id}"))
        .json(&Request {
            currency: currency as u8,
            price,
            seller_user_id,
        })
        .headers(client.requestor.default_headers.clone())
        .send()
        .await;

    let response = client.requestor.validate_response(result).await?;
    client
        .requestor
        .parse_json::<PurchaseResponse>(response)
        .await
}

/// Returns how much `Currency::Robux` the authenticated user has
pub async fn currency(client: &mut Client) -> Result<u64, Error> {
    let result = client
        .requestor
        .client
        .get(format!("{URL}/user/currency"))
        .headers(client.requestor.default_headers.clone())
        .send()
        .await;

    #[derive(Clone, Debug, Deserialize)]
    struct Response {
        robux: u64,
    }

    let response = client.requestor.validate_response(result).await?;
    let response = client.requestor.parse_json::<Response>(response).await?;

    Ok(response.robux)
}

/// Returns how much `Currency::Robux` the user has
pub async fn currency_from_user_id(client: &mut Client, id: u64) -> Result<u64, Error> {
    let result = client
        .requestor
        .client
        .get(format!("{URL}/users/{id}/currency"))
        .headers(client.requestor.default_headers.clone())
        .send()
        .await;

    #[derive(Clone, Debug, Deserialize)]
    struct Response {
        robux: u64,
    }

    let response = client.requestor.validate_response(result).await?;
    Ok(client
        .requestor
        .parse_json::<Response>(response)
        .await?
        .robux)
}

/// Returns how much `Currency::Robux` the group has
pub async fn currency_from_group_id(client: &mut Client, id: u64) -> Result<u64, Error> {
    let result = client
        .requestor
        .client
        .get(format!("{URL}/groups/{id}/currency"))
        .headers(client.requestor.default_headers.clone())
        .send()
        .await;

    #[derive(Clone, Debug, Deserialize)]
    struct Response {
        robux: u64,
    }

    let response = client.requestor.validate_response(result).await?;
    Ok(client
        .requestor
        .parse_json::<Response>(response)
        .await?
        .robux)
}

// TODO:
// assets/{id}/resellers
// assets/{id}/resale-data
// groups/{id}/revenue/summary/{date?}
// groups/{id}/transactions - seems to be 404