Four Pillars (full)

POST

/bazi/four-pillars

request.sh

curl -X POST https://api.astroway.info/v1/bazi/four-pillars \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3 }'

▸ Спробувати POST /bazi/four-pillars

• Production

All four pillars: year, month, day, hour. Day pillar uses HKO-canonical 60-jiazi cycle (anchor 1990-01-01 = Yi-Wei). Pass time to compute hour pillar; pass time + timezoneOffset for traditional 23:00-CST day-shift handling.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

object

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

yearPillar

object

pillar

string

nullable

monthPillar

object

pillar

string

nullable

dayPillar

object

pillar

string

nullable

stem

string

nullable

branch

string

nullable

animal

string

nullable

stemElement

string

nullable

branchElement

string

nullable

yin

boolean

nullable

hourPillar

object

pillar

string

nullable

Example

{
  "ok": true
}

400

Validation error

Media type 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

Media type application/json

Example

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