Reports

Generate Stellaforge Birth-Chart Poster (PDF or HTML)

Changed on

Render a data-rich, print-ready natal chart poster. A high-detail western wheel (colored element sectors, colored glyphs, degree labels, ASC arrow, MC marker, house cusps) plus the Sun/Moon/Rising trio, a placements table, element/modality balance bars, and the top aspects, fully deterministic, 0 AI. Three styles via style: editorial (light), celestial (dark + gold), classic (minimal). White-label via whitelabel. i18n via language. PDF default; ?format=html returns HTML. NB style is read from the request BODY, not the query string.

post/reports/stellaforge

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/reports/stellaforge
  • 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

style'editorial' | 'celestial' | 'classic'
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})?$