Introduction
Have you ever wanted to integrate Vedic astrology insights into your application? Whether you're building a wellness app, a personal development platform, or just curious about combining ancient wisdom with modern technology, astrology APIs can add a unique dimension to your project. In this article, we'll explore how to work with the Vedika API - an AI-powered Vedic astrology service - to create meaningful astrological experiences for your users.
Getting Started with the Vedika API
The Vedika API provides a simple yet powerful way to incorporate Vedic astrology insights into your applications. With just one endpoint, you can generate personalized astrological readings based on birth details and specific questions.
First Steps
Sign up for an API key: Visit api.vedika.io/sandbox to get your free API key for the sandbox environment.
Familiarize yourself with the endpoint: The main endpoint is
POST /api/v1/astrology/query
Making Your First API Call
Let's start with a basic example to see how the API works:
const axios = require('axios');
const getAstrologyInsight = async (question, birthDetails) => {
try {
const response = await axios.post('https://api.vedika.io/api/v1/astrology/query', {
question,
birthDetails
}, {
headers: {
'Authorization': `Bearer YOUR_API_KEY`,
'Content-Type': 'application/json'
}
});
return response.data;
} catch (error) {
console.error('Error fetching astrology insight:', error.response?.data || error.message);
throw error;
}
};
// Example usage
const birthDetails = {
datetime: '1990-05-15T08:30:00',
latitude: 40.7128,
longitude: -74.0060
};
getAstrologyInsight(
"What does my future look like in terms of career?",
birthDetails
)
.then(insight => {
console.log('Astrology insight:', insight);
})
.catch(console.error);
Building a Complete Astrology Feature
Now, let's create a more practical example - a function that can handle different types of astrology queries:
interface BirthDetails {
datetime: string; // ISO 8601 format
latitude: number;
longitude: number;
}
interface AstrologyQuery {
question: string;
birthDetails: BirthDetails;
}
class AstrologyService {
private apiKey: string;
constructor(apiKey: string) {
this.apiKey = apiKey;
}
async askQuestion(query: AstrologyQuery): Promise<string> {
const response = await fetch('https://api.vedika.io/api/v1/astrology/query', {
method: 'POST',
headers: {
'Authorization': `Bearer ${this.apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify(query)
});
if (!response.ok) {
throw new Error(`API request failed with status ${response.status}`);
}
const data = await response.json();
return data.insight; // Assuming the API returns an 'insight' field
}
// Convenience methods for common queries
async getCareerInsight(birthDetails: BirthDetails): Promise<string> {
return this.askQuestion({
question: "What career path would be most fulfilling for me based on my astrological chart?",
birthDetails
});
}
async getRelationshipInsight(birthDetails: BirthDetails): Promise<string> {
return this.askQuestion({
question: "What insights does my astrology offer about my relationships and compatibility?",
birthDetails
});
}
async getMonthlyForecast(birthDetails: BirthDetails): Promise<string> {
return this.askQuestion({
question: "What can I expect in the coming month according to my astrological chart?",
birthDetails
});
}
}
// Usage example
const astrologyService = new AstrologyService('YOUR_API_KEY');
const userBirthDetails: BirthDetails = {
datetime: '1992-03-22T14:45:00',
latitude: 19.0760,
longitude: 72.8777
};
astrologyService.getCareerInsight(userBirthDetails)
.then(insight => {
// Display insight in your UI
console.log('Career insight:', insight);
})
.catch(error => {
console.error('Error:', error);
});
Practical Tips and Gotchas
Date and Time Handling: The API expects datetime in ISO 8601 format. Make sure to convert user input to this format, accounting for time zones.
Location Precision: While the API accepts latitude and longitude, more precise location data will yield more accurate results. Consider using geolocation APIs if you're collecting this data from users.
Rate Limiting: The free sandbox has rate limits. Implement proper error handling for 429 status codes and consider exponential backoff for retries.
Question Formulation: The quality of insights depends heavily on how questions are phrased. Experiment with different formulations to get the best results.
Response Processing: The API returns AI-generated insights, which may vary in length and format. Consider implementing text processing to make the output more consistent for your UI.
Error Handling and Edge Cases
// Enhanced error handling
async function safeAskQuestion(service: AstrologyService, query: AstrologyQuery): Promise<string> {
try {
const insight = await service.askQuestion(query);
// Validate the response
if (!insight || typeof insight !== 'string') {
throw new Error('Invalid response format from API');
}
return insight;
} catch (error) {
if (error instanceof Error) {
if (error.message.includes('rate limit')) {
// Implement your rate limiting strategy
throw new Error('Too many requests. Please try again later.');
} else if (error.message.includes('401')) {
throw new Error('Authentication failed. Please check your API key.');
}
}
throw new Error('Failed to get astrology insight. Please try again.');
}
}
Building a React Component Example
Here's how you might integrate this into a React application:
import React, { useState } from 'react';
const AstrologyWidget = () => {
const [question, setQuestion] = useState('');
const [datetime, setDatetime] = useState('');
const [latitude, setLatitude] = useState('');
const [longitude, setLongitude] = useState('');
const [insight, setInsight] = useState('');
const [loading, setLoading] = useState(false);
const [error, setError] = useState('');
const handleSubmit = async (e) => {
e.preventDefault();
setLoading(true);
setError('');
try {
const astrologyService = new AstrologyService('YOUR_API_KEY');
const response = await astrologyService.askQuestion({
question,
birthDetails: {
datetime: new Date(datetime).toISOString(),
latitude: parseFloat(latitude),
longitude: parseFloat(longitude)
}
});
setInsight(response);
} catch (err) {
setError(err.message);
} finally {
setLoading(false);
}
};
return (
<div className="astrology-widget">
<h2>Astrology Insight</h2>
<form onSubmit={handleSubmit}>
<div>
<label>Question:</label>
<input
type="text"
value={question}
onChange={(e) => setQuestion(e.target.value)}
placeholder="Ask about your career, relationships, etc."
/>
</div>
<div>
<label>Birth Date & Time:</label>
<input
type="datetime-local"
value={datetime}
onChange={(e) => setDatetime(e.target.value)}
/>
</div>
<div>
<label>Latitude:</label>
<input
type="number"
step="any"
value={latitude}
onChange={(e) => setLatitude(e.target.value)}
placeholder="e.g. 40.7128"
/>
</div>
<div>
<label>Longitude:</label>
<input
type="number"
step="any"
value={longitude}
onChange={(e) => setLongitude(e.target.value)}
placeholder="e.g. -74.0060"
/>
</div>
<button type="submit" disabled={loading}>
{loading ? 'Getting Insight...' : 'Get Insight'}
</button>
</form>
{error && <div className="error">{error}</div>}
{insight && (
<div className="insight">
<h3>Your Astrology Insight:</h3>
<p>{insight}</p>
</div>
)}
</div>
);
};
export default AstrologyWidget;
Conclusion and Next Steps
We've explored how to integrate the Vedika API into your applications to provide Vedic astrology insights. From basic API calls to building complete features, you now have the foundation to create engaging astrology-related
Top comments (0)