Testing Kundali API - Horoscope Charts API Using Postman

Visualize cosmic influences with our 'Horoscope Charts' API, generating detailed astrological charts that reveal planetary positions and configurations within the framework of Indian Astrology.

 Last updated : 12 Dec, 2024
 Guide

1. Securing Your API Key

To start, you need an API key. Head over to https://divineapi.com/ and register to initiate your 7-day trial.

  • Select the APIs you are interested in; you can change these selections at any time. You can add or remove APIs in the future.
  • Click on checkout, fill out the sign-up form, and enter your payment details on the next page.

Your trial will begin immediately. You won't be charged during the trial period, and you can cancel anytime without incurring any charges.

  • After logging in, your API key will be visible on your dashboard on the API Key page ( https://divineapi.com/api-keys)

 

2. Importing the Postman Collection

Import our Postman collection to facilitate your API testing:

  • After logging into your Postman account:
  • Open This link: https://documenter.getpostman.com/view/27195761/2sA3Qs8rfV 
  • Click “Run in Postman” and then select “Run in Web”.
  • Select your workspace and then select ‘import’.

 

3. Configuring Your API Request

Once the collection is imported:

  • Locate the "Horoscope Charts" API request.
  • Ensure the method is set to POST.
  • Use this request URL: https://astroapi-3.divineapi.com/indian-api/v1/horoscope-chart/:chart_id 
chart_id means the type of chart for which you want data. For example:-

chalit : For Chalit Chart, 

SUN : For Sun Chart, 

MOON : For Moon Chart, 

D1 : For Brith Chart, 

D2 : For Hora Chart, 

D3 : For Dreshkan Chart, 

D4 : For Chathurthamasha Chart, 

D7 : For Saptamansha Chart, 

D9 : For Navamsha Chart, 

D10 : For Dashamansha Chart, 

D12 : For Dwadashamsha chart, 

D16 : For Shodashamsha Chart, 

D20 : For Vishamansha Chart, 

D24 : For Chaturvimshamsha Chart, 

D27 : For Bhamsha Chart, 

D30 : For Trishamansha Chart, 

D40 : For Khavedamsha Chart, 

D45 : For Akshvedansha Chart, 

D60 : For Shashtymsha Chart,

cuspal : For Cuspal Chart,

 

4. Setting Request Parameters

This API call necessitates only your API key. To find your API key.

  • Go to your DivineAPI dashboard > API Key page.
  • Click on “Copy” next to the API key

 Notice the difference between the key, and the Access Token.

 

Go back to Postman to set the parameters.

  • Navigate to “Authorization”, select “Bearer Token” in the Auth type, and then add the token from your Divine API profile.
  • Navigate to 'Body', select 'form_data', and then add:
    • api_key: “<Your_API_Key>” - Your unique API subscription identifier.
    • full_name: “Your name” - Enter name.
    • day: “24” - Enter the date of birth.
    • month: “05” - Enter the month of birth.
    • year: "2023" - The year of interest.
    • hour: “14” - Enter the hour.
    • min: “40” - Enter the minute.
    • sec: “43” - Enter the second.
    • gender: “male” - Enter the gender.
    • place: "New Delhi" - The name of the city.
    • lat: "28.6139" - Latitude for location-specific details.
    • lon: "77.2090" - Longitude for accurate location insights.
    • tzone: "5.5" - Timezone offset from UTC.
    • lan: “en” - Enter the language.
  • Please ensure that the bearer token is exactly the same as in your profile, with no changes in spacing or formatting.

 

5. Making the Request

Hit the 'Send' button to submit your request.

 

6. Deciphering the Response

The API's response will be structured as follows:

{

{
    "success": 1,
    "data": {
        "svg": "SVG CODE",  
        "data": "raw_data", 
        "base64_image": "base64_svg_image",     
    }
}
  • The Horoscope Charts API response provides three parts: svg for the chart's SVG code, data for raw chart information, and base64_image for a base64-encoded image of the chart. 
  • The chart_id specifies the type of chart, such as 'D1' for Birth Chart or 'D9' for Navamsha Chart, allowing you to retrieve and display various astrological charts.

7. Error Resolution

Ensure your API key is correctly entered if you encounter errors, as most issues are due to invalid or missing API keys.

8. Further Assistance

For additional support or inquiries, feel free to contact our customer service team at admin@divineapi.com.