Testing PDF API - Kundali PDF - Sampoorna API Using Postman

1. Securing Your API Key

Step-by-Step Guide:

Log in to Your Account

• Visit the website  (e.g., report.divineapi.com).
• Use your registered email and password to sign in.

Navigate to the API Credentials Section

• After logging in, locate the menu or user icon (generally at the top right corner).
• Click on it and select the "API Credentials" option from the dropdown menu.

Access Your API Key and Token

• On the API Credentials page, you will see two sections:
  • Live API Credentials: For production use.
  • Test API Credentials: For testing your integration.
• Both sections include the API Key and Bearer Token.

Copy the Credentials

• Use the provided "Copy" button next to the API key and token to copy them securely.

Secure Your API Key and Token

• Never share your API credentials publicly.
• Store them securely in environment variables or encrypted files to prevent unauthorized access.

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 "Kundali PDF - Sampoorna" API request.
• Ensure the method is set to POST.
• Use this request URL

https://pdf.divineapi.com/indian-api/v1/kundali-sampoorna 

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.
  • company_name:“Divine API” - Enter the company name.
  • company_url:“https://divineapi.com/” - Enter the company url.
  • company_email:“admin@divineapi.com” - Enter the company email.
  • company_mobile:“+91 1212 1212 12” - Enter company mobile number.
  • company_bio:“Your Company Bio” - Enter your company bio.
  • logo_url:“logo_url” - Enter the company logo url.
  • footer_text:“Your Company Bio” - Enter your company bio.
• 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": {
        "name": "Your name",
        "report_url": "report_url"
    }
}

• To decipher the API response, check the "success" key to confirm it is 1. 
• Then, retrieve the user's "name" and the generated Kundali PDF report URL from the "report_url" key in the "data" object. 
• This URL directs to the complete Kundali report.

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.