Birth Chart API - Ruby on Rails Integration

Overview

Generate comprehensive Vedic birth charts with planetary positions, houses, and nakshatras

POST /v2/astrology/birth-chart

Pricing: $0.005 per request | Framework: Ruby on Rails | Auth: API Key required

Quick Start

1. Installation

gem install httparty

2. Environment Setup

# .env
VEDIKA_API_KEY=your_api_key_here

Security: Never commit API keys to version control. Always use environment variables.

Complete Implementation

# app/services/birth_chart_service.rb
require 'httparty'

class BirthChartService
  include HTTParty
  base_uri 'https://vedika-api-854222120654.us-central1.run.app'

  def initialize
    @api_key = ENV['VEDIKA_API_KEY']
  end

  def get_birth_chart(params)
    response = self.class.post(
      '/v2/astrology/birth-chart',
      body: params.to_json,
      headers: {
        'Content-Type' => 'application/json',
        'x-api-key' => @api_key
      },
      timeout: 10
    )

    if response.success?
      response.parsed_response
    else
      raise "Vedika API Error: #{response.code} - #{response.message}"
    end
  end
end

# app/controllers/birth_chart_controller.rb
class BirthChartController < ApplicationController
  skip_before_action :verify_authenticity_token, only: [:create]

  def create
    service = BirthChartService.new
    result = service.get_birth_chart(params.permit!)

    render json: result, status: :ok
  rescue => e
    render json: { error: e.message }, status: :internal_server_error
  end
end

# config/routes.rb:
# post '/birth-chart', to: 'birth_chart#create'

Request Parameters

Parameter	Type	Required	Description
`datetime`	varies	Yes	See API documentation
`latitude`	varies	Yes	See API documentation
`longitude`	varies	Yes	See API documentation
`timezone`	varies	Yes	See API documentation

Error Handling

Status Code	Error	Solution
400	Bad Request	Check request parameters and format
401	Unauthorized	Verify API key is correct
402	Payment Required	Insufficient balance - recharge at console.vedika.io
429	Rate Limit Exceeded	Implement exponential backoff or upgrade plan
500	Server Error	Retry after a few seconds

Best Practices

Secure API Keys: Always use environment variables, never hardcode
Error Handling: Implement comprehensive error handling for all status codes
Caching: Cache responses when appropriate to reduce costs
Timeout: Set reasonable timeout values (10-30 seconds)
Rate Limiting: Implement client-side rate limiting to avoid 429 errors
Validation: Validate input parameters before making API calls
Logging: Log API errors for debugging and monitoring
Testing: Use sandbox endpoints for development and testing

Response Format

{
  "success": true,
  "data": {
    // Endpoint-specific response data
  },
  "timestamp": "2026-01-07T10:30:00Z",
  "cost": 0.005
}

Related Endpoints

Kundli Match Panchang Dasha Periods Dosha Analysis

Other Frameworks

React Next.js Vue.js Angular Node.js Python/Flask Django

Support

Need help integrating this endpoint?

Email: support@vedika.io
Documentation: vedika.io/docs
API Console: console.vedika.io
GitHub Examples: github.com/vedika-io/examples