Misar IO Docs

Kotlin SDK

Install and use the MisarBlog Kotlin SDK

Installation

Add to build.gradle.kts:

dependencies {
    implementation("blog.misar:misarblog-sdk:0.1.0")
}

Embed URL

import blog.misar.sdk.MisarBlog

// Single article
val url = MisarBlog.embedUrl("gulshan", slug = "my-article", theme = "dark")
// → "https://misar.blog/gulshan/my-article/embed?theme=dark"

// Profile embed
val url = MisarBlog.embedUrl("gulshan")
// → "https://misar.blog/gulshan/embed"

Token refresh

import blog.misar.sdk.MisarBlog
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
    val result = MisarBlog.refreshToken("your-current-token")
    println(result.token)
    println(result.expiresAt) // Long Unix timestamp
}

Custom base URL:

val result = MisarBlog.refreshToken("your-current-token", baseUrl = "https://your-instance.example.com")

API reference

MisarBlog.embedUrl(username: String, slug: String? = null, theme: String = "auto"): String

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | username | String | — | MisarBlog username | | slug | String? | null | Article slug — null for profile embed | | theme | String | "auto" | "auto" | "light" | "dark" |

suspend MisarBlog.refreshToken(token: String, baseUrl: String = "https://misar.blog"): TokenResult

Suspend function (Ktor CIO client). Returns TokenResult(token: String, expiresAt: Long).