marzban_api 0.2.2

A simple async client which abstracts/simplifies the interactions with the Marzban panel API (https://github.com/Gozargah/Marzban).
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

# marzban_api

A simple async rust client which simplifies the interactions with the [Marzban](https://github.com/Gozargah/Marzban) panel API.

[![Crates.io](https://img.shields.io/crates/v/marzban_api)](https://crates.io/crates/marzban_api)
[![Docs.rs](https://docs.rs/marzban_api/badge.svg)](https://docs.rs/marzban_api)
[![License](https://img.shields.io/crates/l/marzban_api)](./LICENSE)

Updated for Marzban v0.7.0

## Using

Either add it via Cargo:

```sh
cargo add marzban_api
```

or via Cargo.toml:

```toml
[dependencies]
marzban_api = "0.2.2"
```

## Examples

Simple example of using marzban_api:

```rust
use marzban_api::client::MarzbanAPIClient;
use marzban_api::models::auth::BodyAdminTokenApiAdminTokenPost;
use tokio;

#[tokio::main]
async fn main() {
    // Initialize the API client
    let base_url = "https://api.example.com"; // Replace with your actual base URL
    let api_client = MarzbanAPIClient::new(base_url);

    // Authentication, successful authentication will insert token
    // into MarzbanAPIClient, being used for every new API interaction.
    let auth = BodyAdminTokenApiAdminTokenPost {
        grant_type: Some("password".to_string()),
        username: "admin".to_string(), // Replace with your actual admin username
        password: "password".to_string(), // Replace with your actual admin password
        scope: "".to_string(),
        client_id: None,
        client_secret: None,
    };

    match api_client.authenticate(&auth).await {
        Ok(_) => println!("Authentication successful"),
        Err(e) => eprintln!("Authentication failed: {:?}", e),
    }

    // Get current admin
    match api_client.get_current_admin().await {
        Ok(admin) => println!("Current admin: {:?}", admin),
        Err(e) => eprintln!("Failed to get current admin: {:?}", e),
    }
}
```

## Features

- Async API Client from Reqwest
- Error handling
- Full support for all Marzban API endpoints

## Contributing

Contributions are welcome. Please fork the repository and submit a pull request for review.

## License

This project is licensed under the MIT license. See the [LICENSE](./LICENSE) file for more details.

## Acknowledgements

- [Marzban](https://github.com/Gozargah/Marzban) for providing the API.

## Additional Information

For details on the Marzban API and schema, please refer to the [Marzban API Documentation](https://github.com/Gozargah/Marzban)