radar-rs

Crates.ioradar-rs
lib.rsradar-rs
version0.1.0
sourcesrc
created_at2023-07-21 02:19:54.846138
updated_at2024-02-03 18:09:37.32368
descriptionA unofficial library to access Cloudflare Radar data via Cloudflare API.
homepage
repositoryhttps://github.com/bgpkit/radar-rs
max_upload_size
id922011
size17,383
Mingwei Zhang (digizeph)

documentation

https://docs.rs/radar-rs

README

radar-rs: unofficial Cloudflare Radar Rust SDK

The library is still in very early development. Use with caution.

radar-rs is an unofficial Cloudflare Radar API Rust SDK. This library provides a convenient way to access the Cloudflare Radar API, such as BGP routing stats.

Usage

Add the following to your Cargo.toml:

[dependencies]
radar-rs = "0.1" 

Add your API token to the environment variable CF_API_TOKEN.

Then you can use the library as follows:

use radar_rs::RadarClient;
fn main(){
  let client = RadarClient::new().unwrap();
  let global_stats = client.get_bgp_routing_stats(None, None).unwrap();
  println!("global stats: {:?}", global_stats);
  assert!(global_stats.stats.routes_total > 1_000_000);
}

Data License

The use of the Cloudflare data is under CC BY-SA 4.0 license.

This library does not provide any direct access to the API data.

See Cloudflare Radar about page for more details.

Obtain API Token

See Cloudflare Radar API getting started guide for detailed steps on obtaining a API token.

Once you have the API token, you can set it as an environment variable CF_API_TOKEN.

Supported Cloudflare Radar API

  • Radar AS112
  • Radar Annotation
  • Radar Attacks
  • Radar BGP
    • hijack events
    • route leak events
    • MOASes
    • prefix-to-ASN mapping
    • routing table stats
    • BGP messages volume time series
    • top ASNs by BGP update count
    • top ASNs by prefix count
    • top prefixes by BGP update count
  • Radar DNS
  • Radar Datasets
  • Radar Email Security
  • Radar Entities
  • Radar HTTP
  • Radar Netflows
  • Radar Quality
  • Radar Ranking
  • Radar Search
  • Radar Special Events
  • Radar Verified Bots
Commit count: 3

cargo fmt