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 "Synastry Intense Aspect Reading" API request.
- Ensure the method is set to POST.
- Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/synastry/intense-aspect-reading
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.
- p1_full_name: “Person one” - Enter name.
- p1_day: “24” - Enter the date of birth.
- p1_month: “05” - Enter the month of birth.
- p1_year: "1998" - The year of interest.
- p1_hour: “14” - Enter the hour.
- p1_min: “40” - Enter the minute.
- p1_sec: “43” - Enter the second.
- p1_gender: “male” - Enter the gender.
- p1_place: "New Delhi" - The name of the city.
- p1_lat: "28.7041" - Latitude for location-specific details.
- p1_lon: "77.1025" - Longitude for accurate location insights.
- p1_tzone: "5.5" - Timezone offset from UTC.
- p2_full_name: “Person two” - Enter name.
- p2_day: “24” - Enter the date of birth.
- p2_month: “05” - Enter the month of birth.
- p2_year: "1998" - The year of interest.
- p2_hour: “14” - Enter the hour.
- p2_min: “40” - Enter the minute.
- p2_sec: “43” - Enter the second.
- p2_gender: “female” - Enter the gender.
- p2_place: "New Delhi" - The name of the city.
- p2_lat: "28.7041" - Latitude for location-specific details.
- p2_lon: "77.1025" - Longitude for accurate location insights.
- p2_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.
Use translator for other language:
Update translator: https://divineapi.com/translator
en For English
hi For Hindi
pt For Portuguese
fr For French
es For Spanish
ru For Russian
de For German
nl For Dutch
it For Italian
pl For Polish
ar For Arabic
ja For Japanese
zh For Chinese
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": [
{
"p1": {
"planet": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
"p2": {
"planet": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense",
"reading": [
{
"title": "Immediate Bonding",
"description": "When Person one's Ascendant is in conjunction with Person two's Ascendant, it suggests an immediate kinship or familiarity between the two individuals. They're able to understand behavioral patterns and expressions almost intuitively, fostering a natural bond."
},
{
"title": "Shared Outlook",
"description": "This aspect indicates a shared perception of the world. In this case, Person one and Person two can find they view life through a similar lens, which advances mutual understanding and companionship."
},
{
"title": "Identity Validation",
"description": "As Ascendant represents the self-image, Person one and Person two may feel a beautiful sense of self-validation. It seems as if they find a mirror in each other, strengthening their self-esteem and causing them to feel understood on a profound level."
}
]
},
{
"p1": {
"planet": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33"
},
"p2": {
"planet": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33"
},
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense",
"reading": [
{
"title": "Personality Synch",
"description": "A Sun conjunct Sun aspect in synastry indicates that Person one and Person two share a lot of similarities in their fundamental persona. They could relate on a deep level, understanding each other's viewpoints, beliefs, and drives well."
},
{
"title": "Energetic Alignment",
"description": "This conjunction aspect enhances the overall vitality and energy exchange between Person one and Person two. They will both motivate and inspire each other. This aspect also signifies a strong partnership and shared common goals."
},
{
"title": "Potential Issues",
"description": "Though this aspect is generally positive, it's double-edged. Person one and Person two's similarities may result in conflicts and competitions due to their identical approach. They have to learn to appreciate their unique traits and not to overshadow each other."
}
]
},
{
"p1": {
"planet": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33"
},
"p2": {
"planet": "Mars",
"full_degree": "60.1624736",
"sign": "Gemini",
"sign_no": 3,
"longitude": "0:9:45"
},
"orb": 2.85,
"aspect": "Conjunction",
"aspect_type": "Intense",
"reading": [
{
"title": "Vibrant energy",
"description": "When Person one's Sun is in conjunction with Person two's Mars, it reflects an intense and vibrant relationship. There will be a lot of excitement, energy, and sometimes friction. It indicates a relationship full of actions and drive."
},
{
"title": "Passionate connection",
"description": "This aspect brings about a strong physical attraction. Person two's aggressive Mars energy blends with Person one's vitalising Sun energy, leading to a passionate and magnetic resonance. This can result in a fiery, yet very engaging bond between both."
},
{
"title": "Potential disputes",
"description": "The drawback to this aspect is that it can lead to arguments and disputes due to the fire element of both Mars and the Sun. Both Person one and Person two need to work on communication and conflict resolution to ensure the relationship can endure such fiery interactions."
}
]
},
}- The response contains synastry aspect readings, each represented as an object in the "data" array.
- Each object includes details about the planets involved, their positions, the aspect type, and specific readings.
- The readings are arrays of objects with "title" and "description" keys, offering detailed interpretations of each aspect.
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.