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

use serde::{Deserialize, Serialize};
use uuid::Uuid;

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

pub const URL: &str = "https://apis.roblox.com/marketplace-sales/v1";

#[derive(Clone, Debug, Default, Deserialize, Serialize, PartialEq, Eq)]
pub enum MarketEntityType {
    #[default]
    User,
}

#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
pub struct MarketEntity {
    pub id: u64,
    pub kind: MarketEntityType,
}

#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct PurchaseResponse {
    pub pending: bool,
    pub purchased: bool,
    pub purchase_result: String,
    #[serde(rename = "errorMessage")]
    pub error: Option<String>,
}

pub async fn purchase(
    client: &mut Client,
    asset_id: &str,
    product_id: &str,
    price: u64,
    currency: Currency,
    purchaser: MarketEntity,
    seller: MarketEntity,
) -> Result<PurchaseResponse, Error> {
    #[derive(Serialize)]
    #[serde(rename_all = "camelCase")]
    struct Request<'a> {
        #[serde(rename = "collectibleItemId")]
        asset_id: &'a str,
        #[serde(rename = "collectibleProductId")]
        product_id: &'a str,
        #[serde(rename = "expectedCurrency")]
        currency: u8,
        #[serde(rename = "expectedPrice")]
        price: u64,
        #[serde(rename = "expectedPurchaserId")]
        user_id: u64, // ... why
        #[serde(rename = "expectedPurchaserType")]
        purchaser_type: MarketEntityType,
        #[serde(rename = "expectedSellerId")]
        seller_id: u64,
        #[serde(rename = "expectedSellerType")]
        seller_type: MarketEntityType,
        idempotency_key: &'a str,
    }

    let result = client
        .requestor
        .client
        .post(format!("{URL}/item/{asset_id}/purchase-item"))
        .headers(client.requestor.default_headers.clone())
        .json(&Request {
            asset_id,
            product_id,
            currency: currency as u8,
            price,
            user_id: purchaser.id,
            purchaser_type: purchaser.kind,
            seller_id: seller.id,
            seller_type: seller.kind,
            idempotency_key: &Uuid::new_v4().to_string(),
        })
        .send()
        .await;

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