Rust

[dependencies]
snipp = "3"
tokio = { version = "1", features = ["full"] }

use snipp::SnippClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = SnippClient::new("YOUR_API_KEY");

    let me = client.get_user("@me").await?;
    println!("{}", me.user.username.unwrap_or_default());

    Ok(())
}

let client = SnippClient::with_region("YOUR_API_KEY", "eu-west-1")?; // or "us-west-1"

let user = client.get_user("@me").await?.user;
if let Some(limits) = &user.limits {
    println!("{} plan, {}% of weekly quota used", user.plan, limits.usage.used_percent);
}

use snipp::ListOptions;

let opts = ListOptions { limit: Some(10), ..Default::default() };
let page = client.get_user_posts("987654321098765432", Some(opts)).await?;
println!("{} more: {}", page.posts.len(), page.has_more);

use snipp::ListOptions;

let mut cursor = None;
loop {
    let opts = ListOptions { limit: Some(100), cursor };
    let page = client.list_posts(Some(opts)).await?;
    for post in &page.posts {
        println!("{} {}", post.code, post.privacy);
    }
    cursor = page.next_cursor;
    if cursor.is_none() {
        break;
    }
}

let post = client.get_post("AbCd1234").await?.post;
println!("{} {}", post.url, post.files[0].url);

use snipp::{Privacy, UploadOptions};

let opts = UploadOptions {
    privacy: Some(Privacy::Unlisted),
    title: Some("My screenshot".into()),
    ..Default::default()
};
let result = client.upload("image.png", Some(opts)).await?;
println!("{} {}", result.url, result.post.url);

use snipp::{Privacy, UpdatePostOptions};

let opts = UpdatePostOptions {
    title: Some("New title".into()),
    privacy: Some(Privacy::Public),
    ..Default::default()
};
client.update_post("AbCd1234", opts).await?;

use snipp::AddFilesOptions;

let opts = AddFilesOptions { include_metadata: Some(true), ..Default::default() };
let result = client
    .add_files("AbCd1234", &["photo-a.png", "photo-b.png"], Some(opts))
    .await?;

println!("album now has {} files", result.post.file_count);
for failed in result.failed.unwrap_or_default() {
    eprintln!("file {} failed: {}", failed.index, failed.error.message);
}

let post = client.get_post("AbCd1234").await?.post;
client.delete_file("AbCd1234", &post.files[1].name).await?;

client.delete_post("AbCd1234").await?;

client.report_post("AbCd1234", Some("Spam")).await?;

client.report_user("987654321098765432", Some("Impersonation")).await?;

use snipp::SnippError;

match client.upload("image.png", None).await {
    Ok(result) => println!("{}", result.url),
    Err(SnippError::Api { kind: Some(kind), body, .. }) if kind == "quota_exceeded" => {
        let resets_at = body
            .as_ref()
            .and_then(|b| b["error"]["resets_at"].as_str())
            .unwrap_or("soon");
        eprintln!("Weekly quota used up, resets at {resets_at}");
    }
    Err(e) => eprintln!("Error: {e}"),
}