Ashtakoota Matching API - Python/Flask Integration

Overview

Detailed 8-point Guna Milan compatibility analysis

POST /v2/astrology/ashtakoota

Pricing: $0.010 per request | Framework: Python/Flask | Auth: API Key required

Quick Start

1. Installation

pip install requests flask python-dotenv

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

# ashtakoota_matching.py
import os
import requests
from flask import Blueprint, request, jsonify
from dotenv import load_dotenv

load_dotenv()

ashtakoota_matching_bp = Blueprint('ashtakoota_matching', __name__)

VEDIKA_BASE_URL = 'https://vedika-api-854222120654.us-central1.run.app'
VEDIKA_API_KEY = os.getenv('VEDIKA_API_KEY')

def get_ashtakoota_matching(params):
    """
    Detailed 8-point Guna Milan compatibility analysis
    """
    headers = {
        'Content-Type': 'application/json',
        'x-api-key': VEDIKA_API_KEY
    }

    try:
        response = requests.post(
            f'{VEDIKA_BASE_URL}/v2/astrology/ashtakoota',
            json=params,
            headers=headers,
            timeout=10
        )
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        raise Exception(f'Vedika API Error: {str(e)}')

@ashtakoota_matching_bp.route('/ashtakoota-matching', methods=['POST'])
def ashtakoota_matching_route():
    """
    Flask route for Ashtakoota Matching
    """
    try:
        data = request.get_json()
        result = get_ashtakoota_matching(data)
        return jsonify(result), 200
    except Exception as e:
        return jsonify({'error': str(e)}), 500

# app.py usage:
# from ashtakoota_matching import ashtakoota_matching_bp
# app.register_blueprint(ashtakoota_matching_bp, url_prefix='/api')

Request Parameters

Parameter	Type	Required	Description
`maleBirthDetails`	varies	Yes	See API documentation
`femaleBirthDetails`	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.010
}

Related Endpoints

Birth Chart Kundli Match Panchang Dasha Periods Dosha Analysis

Other Frameworks

React Next.js Vue.js Angular Node.js Django Ruby on Rails

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