Nodesty Rust API Client

nodesty.com'un güçlü API'sine Rust uygulamalarınızdan kolayca erişmenizi sağlayan modern, asenkron ve tip güvenli bir istemci kütüphanesi.

🚀 Özellikler

• ⚡ Asenkron Operasyonlar: Tam async destek!
• 🔒 Tip Güvenliği: Güçlü enum/struct yapılarıyla modelleme
• 🔄 Otomatik Serileştirme: JSON ↔ Rust veri tipleri dönüşümü serde ile
• ⚙️ Yapılandırılabilir: Timeout, retry, rate limit ayarları
• 🛡️ Kapsamlı Hata Yönetimi: Standart ApiResponse<T> yapısı
• 📦 Modüler Yapı: Her servis kendi modülü içinde

📋 Desteklenen Servisler

🛠️ Kurulum

Terminalinizde aşağıdaki komutu çalıştırın:

cargo add nodesty-api-library

🔑 Başlangıç

API Token Alma

Nodesty dashboarddan bir erişim belirteci oluşturun.

Temel Kullanım

use nodesty_api_library::{
    models::RestClientOptions,
    NodestyApiClient,
    services::{UserApiService, VpsApiService}
};
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let token = std::env::var("NODESTY_API_TOKEN").expect("Token yok");
    let options = RestClientOptions::new(token)
        .with_timeout_ms(45_000)
        .with_retry(5)
        .with_rate_limit_offset_ms(100);

    let client = Arc::new(NodestyApiClient::new(options)?);
    let user_service = UserApiService::new(client.clone());
    let vps_service = VpsApiService::new(client);

    let user_response = user_service.get_current_user().await?;
    if user_response.success {
        if let Some(user) = user_response.data {
            println!("Hoş geldin {}", user.full_name);
        } else {
            println!("Kullanıcı bilgisi bulunamadı.");
        }
    } else {
        println!("Kullanıcı bilgisi getirilirken hata oluştu: {:?}", user_response.error);
    }

    Ok(())
}

📖 Kullanım Örnekleri

👤 Kullanıcı Bilgileri

let user_service = UserApiService::new(client.clone());
let res = user_service.get_current_user().await?;
if res.success {
    let user = res.data.unwrap();
    println!("Merhaba {}", user.full_name);
    println!("Email: {}", user.email);
} else {
    println!("Hata: {:?}", res.error);
}

🖥️ VPS Yönetimi

let vps_service = VpsApiService::new(client.clone());
let vps_id = "your-vps-id";

use nodesty_api_library::models::vps::VpsAction;
vps_service.perform_action(vps_id, VpsAction::Restart).await?;

let backups = vps_service.get_backups(vps_id).await?.data.unwrap();
for backup in backups {
    println!("Yedek: {} - {}", backup.date, backup.file);
}

🔧 Dedicated Sunucu

let dedicated_service = DedicatedServerApiService::new(client.clone());
let id = "your-dedicated-id";
let res = dedicated_service.get_hardware_components(id).await?;
for part in res.data.unwrap() {
    println!("{}: {} {}{}", part.component, part.model, part.value, part.value_suffix);
}

🛡️ Güvenlik Duvarı

let firewall_service = FirewallApiService::new(client.clone());
use nodesty_api_library::models::firewall::FirewallCreateRuleData;

let rule = FirewallCreateRuleData { port: 25565, app_id: 123 };
firewall_service.create_rule("svc-id", "ip", rule).await?;

let logs = firewall_service.get_attack_logs("svc-id", "ip").await?.data.unwrap();
for log in logs {
    println!("Saldırı Başlangıcı: {} - Vektörler: {:?}", log.started_at, log.vectors);
}

🏗️ API Yanıt Yapısı

Tüm API çağrıları ApiResponse<T> döner:

pub struct ApiResponse<T> {
    pub success: bool,
    pub error: Option<String>,
    pub data: Option<T>,
}

⚙️ Yapılandırma Seçenekleri

let options = RestClientOptions::new(token)
    .with_timeout_ms(30_000)
    .with_retry(3)
    .with_rate_limit_offset_ms(50);

📚 API Servisleri

👤 User Service (UserApiService)

🖥️ VPS Service (VpsApiService)

🔧 Dedicated Service (DedicatedServerApiService)

🛡️ Firewall Service (FirewallApiService)

🔐 Güvenlik İpuçları

• Token'ı .env dosyasından veya ortam değişkeninden alın
• Her ApiResponse sonrası .success kontrolü yapın
• Hataları match veya if let ile detaylı yönetin

🚀 Performans Önerileri

• tokio::join! ile işlemleri paralel çalıştırın
• Rate limit için rate_limit_offset_ms yapılandırmasını ayarlayın
• Uygulama başında istemciyi bir kez oluşturun ve tekrar kullanın

🧪 Test Örneği

#[tokio::test]
async fn test_user_service() -> Result<(), Box<dyn std::error::Error>> {
    let token = std::env::var("NODESTY_TEST_TOKEN").unwrap();
    let client = Arc::new(NodestyApiClient::new(RestClientOptions::new(token))?);
    let user_service = UserApiService::new(client);

    let response = user_service.get_current_user().await?;
    assert!(response.success);
    assert!(response.data.unwrap().email.contains("@"));

    Ok(())
}

🐛 Sorun Giderme

• 401 Unauthorized: Token geçersiz veya süresi dolmuş olabilir
• Timeout: Ağ bağlantısını ve timeout süresini kontrol edin
• Rate Limiting: rate_limit_offset_ms değerini artırın veya daha az istek gönderin

🤝 Katkıda Bulunma

1. Repo'yu forklayın
2. Yeni bir branch oluşturun (git checkout -b feature/harika-ozellik)
3. Commit ve push yapın
4. PR gönderin

🔗 Bağlantılar

• 🌐 Nodesty Website
• 📘 API Dökümantasyonu

⭐ Destek

Bu proje faydalı olduysa ⭐ vererek destekleyebilirsiniz!

Made with ❤️ for Nodesty Community.