Sdks
Ruby SDK
Install and use the MisarBlog Ruby SDK
Installation
gem install misar-blogOr add to your Gemfile:
gem 'misar-blog', '~> 0.1'
Quick Start
require 'misar_blog'
client = MisarBlog::Client.new(api_key: ENV['MISARBLOG_API_KEY'])
posts = client.posts.list('johndoe')
posts.data.each { |p| puts "#{p.title} — #{p.slug}" }
Generate an Embed URL
url = client.embed.url('johndoe', theme: 'dark')
puts url
# Single post
url = client.embed.url('johndoe', slug: 'my-first-post', theme: 'light')
Available Methods
| Method | Description |
|---|---|
client.posts.list(username, params) | List posts for a user |
client.posts.get(username, slug) | Get a single post by slug |
client.embed.url(username, options) | Generate an embed URL |
client.auth.refresh_token(token) | Refresh a session token |
client.webhooks.list | List webhook endpoints |
client.webhooks.create(request) | Register a webhook |
client.webhooks.delete(id) | Delete a webhook |
Error Handling
begin
posts = client.posts.list('johndoe')
rescue MisarBlog::ApiError => e
puts "API error #{e.status_code}: #{e.message}"
rescue MisarBlog::NetworkError => e
puts "Network error: #{e.message}"
end