Java SDK

Installation

Add to pom.xml (requires Java 17+):

<dependency>
  <groupId>blog.misar</groupId>
  <artifactId>misarblog-sdk</artifactId>
  <version>0.1.0</version>
</dependency>

Embed URL

import blog.misar.sdk.MisarBlog;

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

// Profile embed (null slug)
String url = MisarBlog.embedUrl("gulshan", null, "auto");
// → "https://misar.blog/gulshan/embed"

Token refresh

import blog.misar.sdk.MisarBlog;

MisarBlog.TokenResult result = MisarBlog.refreshToken("your-current-token", "https://misar.blog");
System.out.println(result.token());
System.out.println(result.expiresAt()); // long Unix timestamp

API reference

MisarBlog.embedUrl(String username, String slug, String theme): String

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

MisarBlog.refreshToken(String token, String baseUrl): TokenResult

Synchronous (uses java.net.http.HttpClient). Throws Exception on non-200 responses.

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

TokenResult is a Java record: record TokenResult(String token, long expiresAt).