ampapi-rs

An API that allows you to communicate with AMP installations from within Rust.

Documentation for available API calls can be found by appending /API to the URL of any existing AMP installation.

Support:

• Ping @thepotatoking3452 in the #development channel of the AMP Discord
• My own development Discord

Installation

bash cargo add ampapi

Examples

CommonAPI Example

```rust use ampapi::modules::CommonAPI; use ampapi::types::Status;

fn main() { // If you know the module that the instance is using, specify it instead of CommonAPI let api = CommonAPI::new( String::from("http://localhost:8080/"), String::from("admin"), String::from("myfancypassword123"), "".tostring(), "".tostring() );

// API call parameters are simply in the same order as shown in the documentation.
let _ = api.Core.SendConsoleMessage("say Hello Everyone, this message was sent from the Rust API!".to_string());

let current_status: Status = api.Core.GetStatus().unwrap();
let cpu_usage_percent: f64 = current_status.Metrics.get("CPU Usage").unwrap().get("Percent").unwrap().as_f64().unwrap();

println!("Current CPU usage is: {}%", cpu_usage_percent);

} ```

Example using the ADS to manage an instance

```rust use ampapi::modules::{ADS, Minecraft}; use ampapi::types::{IADSInstance, Status};

fn main() { let api = ADS::new( String::from("http://localhost:8080/"), String::from("admin"), String::from("myfancypassword123"), "".tostring(), "".tostring() );

// Get the available instances
let instances_result = api.ADSModule.GetInstances().unwrap();
let targets: Vec<IADSInstance> = instances_result.result;

// In this example, my Hub server is on the second target
// If you're running a standalone setup, you can just use targets[0]
// Get the instance ID of the Hub server
let hub_instance_id = targets[1].AvailableInstances.iter().find(|&x| x.InstanceName == "Hub").unwrap().InstanceID.clone();

// Use the instance ID to get the API for the instance
let hub: Minecraft = api.instance_login(hub_instance_id, "Minecraft".to_string()).unwrap().into();

// Get the current CPU usage
let current_status: Status = api.Core.GetStatus().unwrap();
let cpu_usage_percent: f64 = current_status.Metrics.get("CPU Usage").unwrap().get("Percent").unwrap().as_f64().unwrap();

// Send a message to the console
let _ = hub.Core.SendConsoleMessage(format!("say Current CPU usage is: {}%", cpu_usage_percent)).unwrap();

} ```

CommonAPI Example, handling the sessionId and rememberMeToken manually (not recommended)

rust fn main() { // Under implementation }