Misar IO Docs

SDK Overview

Embed MisarBlog articles and manage auth tokens from any language

What is the MisarBlog SDK?

The MisarBlog SDK lets you embed articles and handle authentication token refresh from your own apps. It wraps two endpoints on the misar.blog platform:

  • embed_url / embedUrl — build the URL for an embedded article iframe
  • refresh_token / refreshToken — exchange an expiring token for a fresh one

Base URL

https://misar.blog

Available SDKs

| Language | Package | Registry | |----------|---------|----------| | TypeScript / JavaScript | @misar/blog | npm | | Python | misarblog-sdk | PyPI | | Go | github.com/misar-ai/misarblog-go | pkg.go.dev | | PHP | misarblog/sdk | Packagist | | Ruby | misarblog | RubyGems | | Rust | misarblog-sdk | crates.io | | Kotlin | blog.misar:misarblog-sdk | Maven Central | | Java | blog.misar:misarblog-sdk | Maven Central | | Swift | MisarBlog | Swift Package Manager | | C# | MisarBlog | NuGet | | Dart | misarblog_sdk | pub.dev | | Flutter | misarblog_flutter | pub.dev |

Embed URL Format

https://misar.blog/{username}/embed                  # profile embed
https://misar.blog/{username}/{slug}/embed           # single article embed
https://misar.blog/{username}/{slug}/embed?theme=dark

Supported theme values: auto (default), light, dark.

Token Refresh Endpoint

POST https://misar.blog/api/auth/refresh
Content-Type: application/json

{ "token": "<your-token>" }

Response:

{ "token": "new-token-string", "expiresAt": 1713456789 }

expiresAt is a Unix timestamp (seconds).