Reports

Generate Gemstone Report (PDF or HTML)

Changed on

The ratna prescription as a multi-page A4 PDF (default) or live HTML (add ?format=html). Same astrology as POST /vedic/gemstones, and pinned by a test to never disagree with it: same sidereal lagna, same two schools, same three gems. What the document adds is what a table cannot carry. Every recommended gem gets a page: what the graha it belongs to signifies classically, the basis in house ownership, mineral and substitutes, weight in ratti with gram and carat conversions, weekday, finger, metal, mantra and japa count, and the next auspicious day to first wear it, found by scanning the Panchang for the nearest favourable day that falls on that graha own weekday. The school is named on the cover: the two prescribe the same gems but withhold different ones, so a document that hid which produced it would be less honest than the JSON. Coordinates are required and never defaulted. The gemmologist and physician boundary is carried verbatim from the JSON endpoint.

post/reports/gemstone

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/reports/gemstone
  • Auth: API key in header X-Api-Key

Query parameters

retain_daysinteger

How many days the PDF stays at its url. 1 by default; up to 90 for a link you hand to a client. Delete it sooner with DELETE /v1/reports/files/{filename}.

format'pdf' | 'html'

html returns the rendered report as text/html instead of storing a PDF; nothing is kept.

fieldsstring

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

precisioninteger

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Request body

school'lagna-lord' | 'functional-benefic'
wearingFromstring
language'uk' | 'en' | 'de' | 'ru' | 'pl' | 'es' | 'pt' | 'hi' | 'fr' | 'ko' | 'it' | 'ja' | 'id' | 'tr' | 'nl' | 'ro' | 'cs' | 'vi' | 'ar' | 'el' | 'hu'

Example request

{
  "chart": {
    "timezone": "Europe/Kyiv"
  }
}

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}

Changes

  • e9234ffdb4f0Revision changes
    • info

      added the new optional query request parameter format

    • info

      added the new optional query request parameter retain_days

  • ec98fcd88094Revision changes
    • warning

      changed the pattern of the request property ///// from ^\d{2}:\d{2}:\d{2}$ to ^\d{2}:\d{2}(:\d{2})?$