serverseeker 0.3.11

Rust wrapper for DAMcrafts Minecraft ServerSeeker API
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

use crate::ServerSeekerClient;
use derive_builder::Builder;
use reqwest::Method;
use serde::{Deserialize, Serialize, Serializer};

#[derive(Serialize, Builder, Default)]
#[builder(name = "WhereisBuilder", public, setter(strip_option), default)]
pub struct WhereisParams {
    /// The name of the player you want to find
    #[builder(setter(into))]
    pub name: Option<String>,

    /// The uuid of the player you want to find
    #[builder(setter(into))]
    pub uuid: Option<String>,
}

/// A server in the results
#[derive(Deserialize, Debug)]
pub struct WhereisServer {
    /// The last time the player was seen on the server (unix timestamp)
    pub last_seen: i64,

    /// The name of the player
    pub name: String,

    /// The ip:port of the server
    pub server: String,

    /// The uuid of the player
    pub uuid: String,
}

/// The data array from the response
#[derive(Deserialize, Debug)]
pub(crate) struct WhereisData {
    /// An array of servers the player was seen on. Limited to 1000
    pub data: Vec<WhereisServer>,
}

impl ServerSeekerClient {
    /// Get all servers a player was on during a scan
    pub async fn whereis(
        &self,
        builder: &WhereisBuilder,
    ) -> anyhow::Result<Vec<WhereisServer>> {
        let mut params = builder.build()?;
        Ok(self
            .request::<WhereisData, _, _>("/whereis", params, Method::POST)
            .await?
            .data)
    }
}