PHP SDK

Installation

composer require misarblog/sdk

Embed URL

use MisarBlog\Embed;

// Single article
$url = Embed::url('gulshan', 'my-article', 'dark');
// → "https://misar.blog/gulshan/my-article/embed?theme=dark"

// Profile embed
$url = Embed::url('gulshan');
// → "https://misar.blog/gulshan/embed"

Token refresh

use MisarBlog\Auth;

$result = Auth::refreshToken('your-current-token');
echo $result['token'];
echo $result['expiresAt']; // Unix timestamp

Custom base URL:

$result = Auth::refreshToken('your-current-token', 'https://your-instance.example.com');

API reference

Embed::url(string $username, ?string $slug = null, string $theme = 'auto'): string

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

Auth::refreshToken(string $token, string $baseUrl = 'https://misar.blog'): array

Returns associative array ['token' => string, 'expiresAt' => int]. Throws RuntimeException on failure.