Documentation

  1. Home
  2. Documentation
Introduction

Quick Start Guide

Intro to developer resources

Getting Started

In this guide, you'll learn how to use the AstroBeansAPI to request natal chart details for the given birth details. We will use Postman to call the APIs.

Before You Start

Make sure you already have the Merchant-Id and API Key required to make API requests. If not, you can generate a new Merchant-Id and API Key by signing up and found in API Keys Management. You will also need the Postman tool which you can get free from here. The base url of api is https://api.astrobeans.com

  • STEP 1

    Initial Setup

    1. Open Postman on your computer.
    2. Select the HTTP method as POST. We are going to use this API - /panchang/v1/detail
    3. Copy the full API URL and paste as below
    step1

  • STEP 2

    Add Authentication

    1. Go to the Auth tab of Postman.
    2. Since all the APIs need authentication. Open headers tab.
    3. Now, enter your Merchant-Id as the username and API-Key as the password.
    authentication

  • STEP 3

    Add Request Parameters / Birth Details

    1. Now, go to the Body tab of Postman and select raw with json data type.
    2. Follow the request parameters from the API doc and add them one by one as shown below:
    authentication

  • STEP 4

    Send Request

    Once you have set up everything as mentioned above, you can call the API using the Send button. You will receive a response in JSON format as shown below.

    authentication

    And there you go, making your first successful call to AstroBeansAPI. Similarly, you can just replace the API URL and test other APIs too.