Gemstone (ratna) recommendation

POST

/vedic/gemstones

curl -X POST https://api.astroway.info/v1/vedic/gemstones \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "school": "lagna-lord" }'

const res = await fetch('https://api.astroway.info/v1/vedic/gemstones', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "school": "lagna-lord"
  }),
});
const { ok, data, error } = await res.json();
if (!ok) throw new Error(error.message);
console.log(data);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/gemstones',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
      'date': "1990-05-15",
      'time': "14:30:00",
      'timezoneOffset': 3,
      'latitude': 50.45,
      'longitude': 30.52,
      'school': "lagna-lord"
    },
)
result = r.json()
if not result['ok']:
    raise RuntimeError(result['error']['message'])
print(result['data'])

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('vedic/gemstones', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-05-15',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.45,
        'longitude' => 30.52,
        'school' => 'lagna-lord',
    ],
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

Which of the nine gems to wear, from the sidereal lagna. Two schools are implemented: lagna-lord (default) prescribes the gems of the 1st, 9th and 5th lords as the life, lucky and benefic stones; functional-benefic classifies every graha by the houses it owns from the lagna, prescribes only for functional benefics led by the yogakaraka, and names the functional malefics as gems to avoid. Both reach the same three gems, because a functional benefic is a graha owning a trikona and the trikona lords are the 1st, 5th and 9th: the school changes the ordering, the role each gem carries, and the avoid list. The response always reports which one produced it. Coordinates are required, since the whole answer is derived from the lagna. Each gem carries its substitutes, day, finger, metal, weight range in ratti/grams/carats, and beeja mantra. Planet dignity is returned as context and does not change the list.

Authorizations

ApiKeyAuth

Request Body^required

application/json

Birth data for a gemstone recommendation. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude. Coordinates do NOT default to 0 here as they do on other chart endpoints: the whole answer is derived from the lagna, so an omitted pair is a 400 rather than a confident set of gems for 0N 0E.

object

date required

string

/^\d{4}-\d{2}-\d{2}$/

time required

string

/^\d{2}:\d{2}:\d{2}$/

timezoneOffset

number

0 nullable

latitude

number

0 nullable

longitude

number

0 nullable

houseSystem

string

default: P

name

string

city

string

zodiacType

string

Allowed values: tropical sidereal

ayanamsaId

number

nullable

cosmogram

boolean

latitude required

Birth latitude. Required: the lagna is what both schools prescribe from.

number

nullable >= -90 <= 90

longitude required

Birth longitude. Required: the lagna is what both schools prescribe from.

number

nullable >= -180 <= 180

school

Prescription school. Both reach the same three gems (the trikona lords), and differ on what they withhold and on the ordering. The response always names the one used. Default: lagna-lord.

string

Allowed values: lagna-lord functional-benefic

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "school": "lagna-lord"
}

Responses

200

Successful calculation

application/json

object

boolean

data

object

type

string

nullable

school

string

nullable

lagna

object

sign

number

nullable

signName

string

nullable

lord

number

nullable

lordName

string

nullable

recommended

Array<object>

nullable

object

role

string

nullable

graha

number

nullable

gem

string

nullable

gemSanskrit

string

nullable

housesOwned

Array<number>

nullable

basis

string

nullable

substitutes

Array<string>

nullable

wearing

object

day

string

nullable

finger

string

nullable

metals

Array<string>

nullable

minWeight

object

ratti

Array<number>

nullable

carats

Array<number>

nullable

mantra

string

nullable

japaCount

number

nullable

avoid

Array

nullable

cautions

Array

nullable

condition

object

Venus

object

signName

string

nullable

dignity

string

nullable

isCombust

boolean

nullable

disclaimer

string

nullable

Example

{
  "ok": true
}

400

Validation error

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}

Корисно?

Запропонувати правку

// Назад

Bhava Bala — house strength

Далі //

Navaratna reference table

Gemstone (ratna) recommendation

Authorizations

Request Body required

Example

Responses

200

Example

400

Example

401

Example

Request Body^required