Misar.io Documentation

Installation

Add to Cargo.toml:

[dependencies]
misarblog-sdk = "0.1"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Embed URL

use misarblog_sdk::embed_url;

// Single article
let url = embed_url("gulshan", Some("my-article"), "dark");
// → "https://misar.blog/gulshan/my-article/embed?theme=dark"

// Profile embed
let url = embed_url("gulshan", None, "auto");
// → "https://misar.blog/gulshan/embed"

Token refresh

use misarblog_sdk::refresh_token;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let result = refresh_token("your-current-token", "https://misar.blog").await?;
    println!("{}", result.token);
    println!("{}", result.expires_at); // i64 Unix timestamp
    Ok(())
}

API reference

`embed_url(username: &str, slug: Option<&str>, theme: &str) -> String`

| Parameter | Type | Description | |-----------|------|-------------| | username | &str | MisarBlog username | | slug | Option<&str> | Article slug — None for profile embed | | theme | &str | "auto" | "light" | "dark" |

`refresh_token(token: &str, base_url: &str) -> Result<TokenResult, reqwest::Error>`

Async. Returns TokenResult { token: String, expires_at: i64 }.

| Parameter | Type | Description | |-----------|------|-------------| | token | &str | Current token | | base_url | &str | Base URL (e.g. "https://misar.blog") |

Rust SDK