Astroapi Ruby Client

gem 'astroapi'

require 'astroapi'

# Initialize client with API key
client = Astroapi::Client.new(api_key: 'your-api-key')

# Get planetary positions
positions = client.data.get_positions(
  subject: {
    birth_data: {
      year: 1990,
      month: 5,
      day: 11,
      hour: 14,
      minute: 30,
      city: 'London',
      country_code: 'GB'
    }
  }
)

puts positions['sun'] # => { "name" => "Sun", "longitude" => 20.5, "sign" => "Taurus", ... }

client = Astroapi::Client.new(api_key: 'your-api-key')

client = Astroapi::Client.new

client = Astroapi::Client.new do |config|
  config.api_key = 'your-api-key'
  config.timeout = 15
  config.debug = true
end

client = Astroapi::Client.new do |config|
  config.api_key = 'your-api-key'
  config.retry.attempts = 3
  config.retry.delay_ms = 500
  config.retry.retry_status_codes = [408, 429, 500, 502, 503, 504]
end

# Single subject (most endpoints)
request = {
  subject: {
    birth_data: {
      year: 1990, month: 5, day: 11,
      hour: 14, minute: 30,
      city: 'London', country_code: 'GB'
    }
  }
}

# Two subjects (synastry, compatibility)
request = {
  subject1: { birth_data: { year: 1990, month: 5, day: 11, hour: 14, minute: 30, city: 'London', country_code: 'GB' } },
  subject2: { birth_data: { year: 1985, month: 3, day: 22, hour: 10, minute: 0, city: 'Paris', country_code: 'FR' } }
}

# Using coordinates instead of city
request = {
  subject: {
    birth_data: {
      year: 1990, month: 5, day: 11,
      hour: 14, minute: 30,
      latitude: 51.5074, longitude: -0.1278
    }
  }
}

positions = client.data.get_positions(subject: { birth_data: birth_data })
aspects = client.data.get_aspects(subject: { birth_data: birth_data })
house_cusps = client.data.get_house_cusps(subject: { birth_data: birth_data })
lunar = client.data.get_lunar_metrics(subject: { birth_data: birth_data })
now = client.data.get_current_moment

natal = client.charts.get_natal_chart(subject: { birth_data: birth_data })
synastry = client.charts.get_synastry_chart(subject1: { birth_data: bd1 }, subject2: { birth_data: bd2 })

# Transit chart requires transit_time with datetime wrapper + location
transit = client.charts.get_transit_chart(
  subject: { birth_data: birth_data },
  transit_time: {
    datetime: { year: 2024, month: 6, day: 15, hour: 12, minute: 0, city: 'London', country_code: 'GB' }
  }
)

# Return charts
solar = client.charts.get_solar_return_chart(subject: { birth_data: birth_data }, return_year: 2024)
lunar = client.charts.get_lunar_return_chart(subject: { birth_data: birth_data }, return_date: '2024-06-15')

# Sign-based horoscopes (use 3-letter sign codes: Ari, Tau, Gem, Can, Leo, Vir, Lib, Sco, Sag, Cap, Aqu, Pis)
daily = client.horoscope.get_sign_daily_horoscope(sign: 'Ari')
weekly = client.horoscope.get_sign_weekly_horoscope(sign: 'Tau')

# Personal horoscopes (based on birth data)
personal = client.horoscope.get_personal_daily_horoscope(subject: { birth_data: birth_data })

natal_report = client.analysis.get_natal_report(subject: { birth_data: birth_data })
compatibility = client.analysis.get_compatibility_analysis(subject1: { birth_data: bd1 }, subject2: { birth_data: bd2 })
career = client.analysis.get_career_analysis(subject: { birth_data: birth_data })

chart = client.vedic.get_chart(birth_data: birth_data)         # birth_data at root level
panchang = client.vedic.get_panchang(birth_data: birth_data)
dasha = client.vedic.get_vimshottari_dasha(birth_data: birth_data)
matching = client.vedic.get_kundli_matching(subject1: { birth_data: bd1 }, subject2: { birth_data: bd2 })

cards = client.tarot.get_cards_glossary
daily = client.tarot.get_daily_card(user_id: 'user-123')
draw = client.tarot.draw_cards(count: 3)
report = client.tarot.generate_celtic_cross_report(subject: { birth_data: birth_data })
# Card IDs are strings like "major_00", "major_01", "cups_01", etc.
dignities = client.tarot.calculate_elemental_dignities(cards: [{ id: 'major_00', position: 0 }])

# Relationship insights
compat = client.insights.relationship.get_compatibility(subject1: { birth_data: bd1 }, subject2: { birth_data: bd2 })

# Financial insights
timing = client.insights.financial.get_market_timing(subject: { birth_data: birth_data })

# Business insights
team = client.insights.business.get_team_dynamics(subject: { birth_data: birth_data })

# Pet insights
pet = client.insights.pet.get_personality(
  subject: { birth_data: birth_data },                  # owner
  pet: { birth_data: { year: 2020, month: 3, day: 15, hour: 8, minute: 0, city: 'London', country_code: 'GB' } }
)

# SVG charts return raw SVG string
svg = client.svg.get_natal_chart_svg(subject: { birth_data: birth_data })

# PNG charts return raw binary data
png = client.render.render_natal(subject: { birth_data: birth_data })

# PDF reports return a Hash with URL or raw data
pdf = client.pdf.generate_natal_report(subject: { birth_data: birth_data })

# Chinese astrology
bazi = client.chinese.calculate_bazi(birth_data: birth_data)

# Human Design
bodygraph = client.human_design.calculate_bodygraph(birth_data: birth_data)

# Kabbalah (birth_data at root level)
angels = client.kabbalah.get_birth_angels(birth_data: birth_data)

# Horary
chart = client.horary.generate_chart(
  question: 'Will I get the job?',
  question_time: { year: 2024, month: 6, day: 15, hour: 14, minute: 30, city: 'London', country_code: 'GB' }
)

# Feng Shui
stars = client.fengshui.calculate_flying_stars_chart(birth_data: birth_data)

# Zi Wei Dou Shu (birth_data at root level)
ziwei = client.ziwei.calculate_chart(birth_data: birth_data)

# Palmistry
reading = client.palmistry.analyze(image_url: 'https://example.com/palm.jpg')

# Numerology
numbers = client.numerology.get_core_numbers(subject: { birth_data: birth_data })

begin
  positions = client.data.get_positions(subject: { birth_data: { ... } })
rescue Astroapi::ValidationError => e
  puts "Invalid input: #{e.message}"
rescue Astroapi::ClientError => e
  puts "Client error (#{e.status_code}): #{e.message}"
rescue Astroapi::ServerError => e
  puts "Server error (#{e.status_code}): #{e.message}"
rescue Astroapi::TimeoutError => e
  puts "Request timed out: #{e.message}"
rescue Astroapi::ConnectionError => e
  puts "Connection failed: #{e.message}"
rescue Astroapi::Error => e
  puts "API error: #{e.message}"
end