Ruby SDK

require 'net/http'
require 'json'
require 'uri'
 
ORSA_API_KEY = ENV['ORSA_API_KEY']
BASE_URL = 'https://api.orsa.dev'
 
def orsa_get(path, params = {})
  uri = URI("#{BASE_URL}#{path}")
  uri.query = URI.encode_www_form(params) unless params.empty?
 
  request = Net::HTTP::Get.new(uri)
  request['Authorization'] = "Bearer #{ORSA_API_KEY}"
 
  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end
 
  JSON.parse(response.body)
end
 
def orsa_post(path, body = {})
  uri = URI("#{BASE_URL}#{path}")
 
  request = Net::HTTP::Post.new(uri)
  request['Authorization'] = "Bearer #{ORSA_API_KEY}"
  request['Content-Type'] = 'application/json'
  request.body = body.to_json
 
  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end
 
  JSON.parse(response.body)
end
 
# Retrieve brand data
brand = orsa_get('/v1/brand/retrieve', domain: 'stripe.com')
puts brand['data']['name']     # "Stripe"
puts brand['data']['colors']   # ["#635BFF", "#0A2540", "#00D4AA"]
 
# Scrape markdown
page = orsa_get('/v1/web/scrape/markdown', url: 'https://stripe.com/pricing')
puts page['data']['word_count']
 
# AI query
result = orsa_post('/v1/brand/ai/query', {
  domain: 'stripe.com',
  data_to_extract: 'pricing plans with features',
  response_format: 'json'
})
puts result['data']['result']

require 'faraday'
require 'json'
 
conn = Faraday.new(url: 'https://api.orsa.dev') do |f|
  f.request :json
  f.response :json
  f.headers['Authorization'] = "Bearer #{ENV['ORSA_API_KEY']}"
end
 
# Retrieve brand
response = conn.get('/v1/brand/retrieve', domain: 'github.com')
brand = response.body
puts brand['data']['name']  # "GitHub"
 
# Scrape images
response = conn.get('/v1/web/scrape/images', url: 'https://github.com')
images = response.body
puts images['count']
 
# Start a crawl
response = conn.post('/v1/web/crawl') do |req|
  req.body = { url: 'https://github.com', maxPages: 20 }
end
puts response.body['jobId']

response = conn.get('/v1/brand/retrieve', domain: 'nonexistent.invalid')
 
case response.status
when 200
  puts response.body['data']
when 400
  puts "Bad request: #{response.body['error']['message']}"
when 401
  puts "Invalid API key"
when 404
  puts "Brand not found"
when 429
  retry_after = response.headers['retry-after']
  puts "Rate limited. Retry in #{retry_after}s"
  sleep(retry_after.to_i)
when 500
  puts "Server error: #{response.body['error']['message']}"
end