2 unstable releases

0.2.0 Jan 28, 2024
0.1.0 Jan 18, 2024

#617 in Web programming

32 downloads per month

MIT license

71KB
1.5K SLoC

Zabbix API

This is a partial implementation of the Zabbix API client, created specifically for my pet project, wszl. Due to the extensive nature of the Zabbix API, I have been unable to allocate sufficient time to cover 100% functionality.

Getting started

Add dependencies:

[dependencies]
reqwest = { version = "0.11.23", features = ["blocking", "json"] }
zabbix-api = "0.2.0"

Then use:

use reqwest::blocking::ClientBuilder;
use crate::client::v6::ZabbixApiV6Client;
use crate::client::ZabbixApiClient;

fn main() {
  let http_client = ClientBuilder::new()
                                .danger_accept_invalid_certs(false) // Set true if you're using self-signed certificates.
                                .build().unwrap();

  let client = ZabbixApiV6Client::new(http_client, "http://localhost:3080/api_jsonrpc.php");
    
  match client.get_auth_session("Admin", "zabbix") {
    Ok(session) => println!("session: {session}"),
    Err(e) => {
        eprintln!("error: {}", e);
        panic!("unexpected error")
    }
  }
}

Versions

  • Stable: 0.2.0
  • Dev: 0.3.0

API Methods

  • Get API info
  • Authentication
  • RAW API Call
  • Search
    • Host Group
    • Hosts
    • Items
    • Triggers
    • Web-scenarios
    • User Group
    • User
  • Create
    • Host Group
    • Host
    • Item
    • Trigger
    • Web-scenario
    • User Group
    • User

TODO

  • Add examples
  • Use enums for Zabbix types (trigger type, value type, etc.)

Limitations

  • API support: v6
  • Synchronous requests only

Dependencies

~4–18MB
~256K SLoC