Ruby SDK

Installation

gem install misarblog

Or add to your Gemfile:

gem 'misarblog'

Embed URL

require 'misarblog'

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

# Profile embed
url = MisarBlog.embed_url(username: 'gulshan')
# → "https://misar.blog/gulshan/embed"

Token refresh

require 'misarblog'

result = MisarBlog.refresh_token('your-current-token')
puts result[:token]
puts result[:expires_at] # Unix timestamp

Custom base URL:

result = MisarBlog.refresh_token('your-current-token', base_url: 'https://your-instance.example.com')

API reference

MisarBlog.embed_url(username:, slug: nil, theme: "auto") → String

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | username: | String | — | MisarBlog username (required) | | slug: | String, nil | nil | Article slug — nil for profile embed | | theme: | String | "auto" | "auto" | "light" | "dark" |

MisarBlog.refresh_token(token, base_url: "https://misar.blog") → Hash

Returns {token: String, expires_at: Integer}. Raises Net::HTTPError on failure.