Trigram Analysis

Відкрити як Markdown Налаштування агента

POST

/iching/trigram-analysis

curl -X POST https://api.astroway.info/v1/iching/trigram-analysis \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "hexagram": 63 }'

const res = await fetch('https://api.astroway.info/v1/iching/trigram-analysis', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "hexagram": 63
  }),
});
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/iching/trigram-analysis',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
      'hexagram': 63
    },
)
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('iching/trigram-analysis', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'hexagram' => 63,
    ],
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

For a hexagram (number or lines): both trigrams in full, the image (upper over lower), the five-phase relation of upper to lower, the nuclear trigrams and nuclear hexagram (lines 2-4 and 3-5), the inverse (turned over) and the complement (every line changed).

Authorizations

ApiKeyAuth

Parameters

Query Parameters

fields

string

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.

Example

planets.name,planets.longitude

precision

integer

<= 15

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.

Example

Header Parameters

Idempotency-Key

string

>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.

Example

01HXY2A7ZM0ABCDEF

Request Body^required

application/json

object

hexagram

King Wen number.

integer

>= 1 <= 64

lines

Six line values, bottom to top: 6 old yin (changing), 7 young yang, 8 young yin, 9 old yang (changing). Send the coins you threw yourself.

Array

Example

{
  "hexagram": 63
}

Responses

200

Successful calculation

application/json

object

boolean

data

object

hexagram

object

number

nullable

name

string

nullable

pinyin

string

nullable

legge

string

nullable

chinese

string

nullable

lines

Array<number>

nullable

lowerTrigram

number

nullable

upperTrigram

number

nullable

judgment

string

nullable

lowerTrigram

object

index

number

nullable

name

string

nullable

symbol

string

nullable

lines

Array<number>

nullable

pinyin

string

nullable

chinese

string

nullable

image

string

nullable

attribute

string

nullable

family

string

nullable

animal

string

nullable

bodyPart

string

nullable

earlierHeaven

object

number

nullable

direction

string

nullable

laterHeaven

object

number

nullable

direction

string

nullable

phase

string

nullable

upperTrigram

object

index

number

nullable

name

string

nullable

symbol

string

nullable

lines

Array<number>

nullable

pinyin

string

nullable

chinese

string

nullable

image

string

nullable

attribute

string

nullable

family

string

nullable

animal

string

nullable

bodyPart

string

nullable

earlierHeaven

object

number

nullable

direction

string

nullable

laterHeaven

object

number

nullable

direction

string

nullable

phase

string

nullable

image

string

nullable

phases

object

upper

string

nullable

lower

string

nullable

upperToLower

string

nullable

nuclear

object

lowerTrigram

object

index

number

nullable

name

string

nullable

symbol

string

nullable

lines

Array<number>

nullable

pinyin

string

nullable

chinese

string

nullable

image

string

nullable

attribute

string

nullable

family

string

nullable

animal

string

nullable

bodyPart

string

nullable

earlierHeaven

object

number

nullable

direction

string

nullable

laterHeaven

object

number

nullable

direction

string

nullable

phase

string

nullable

upperTrigram

object

index

number

nullable

name

string

nullable

symbol

string

nullable

lines

Array<number>

nullable

pinyin

string

nullable

chinese

string

nullable

image

string

nullable

attribute

string

nullable

family

string

nullable

animal

string

nullable

bodyPart

string

nullable

earlierHeaven

object

number

nullable

direction

string

nullable

laterHeaven

object

number

nullable

direction

string

nullable

phase

string

nullable

hexagram

number

nullable

rule

string

nullable

inverse

object

hexagram

number

nullable

rule

string

nullable

symmetric

boolean

nullable

complement

object

hexagram

number

nullable

rule

string

nullable

source

string

nullable

Example

{
  "ok": true,
  "data": {
    "hexagram": {
      "number": 63,
      "name": "After Completion",
      "pinyin": "Ji Ji",
      "legge": "Kî Zî",
      "chinese": "䷾",
      "lines": [
        1,
        0,
        1,
        0,
        1,
        0
      ],
      "lowerTrigram": 6,
      "upperTrigram": 3,
      "judgment": "Kî Zî intimates progress and success in small matters. There will be advantage in being firm and correct. There has been good fortune in the beginning; there may be disorder in the end."
    },
    "lowerTrigram": {
      "index": 6,
      "name": "Li (Fire)",
      "symbol": "☲",
      "lines": [
        1,
        0,
        1
      ],
      "pinyin": "Li",
      "chinese": "離",
      "image": "fire, the sun",
      "attribute": "brightness",
      "family": "middle daughter",
      "animal": "pheasant",
      "bodyPart": "eyes",
      "earlierHeaven": {
        "number": 3,
        "direction": "east"
      },
      "laterHeaven": {
        "number": 9,
        "direction": "south"
      },
      "phase": "fire"
    },
    "upperTrigram": {
      "index": 3,
      "name": "Kan (Water)",
      "symbol": "☵",
      "lines": [
        0,
        1,
        0
      ],
      "pinyin": "Kan",
      "chinese": "坎",
      "image": "water",
      "attribute": "peril",
      "family": "middle son",
      "animal": "pig",
      "bodyPart": "ears",
      "earlierHeaven": {
        "number": 6,
        "direction": "west"
      },
      "laterHeaven": {
        "number": 1,
        "direction": "north"
      },
      "phase": "water"
    },
    "image": "water over fire",
    "phases": {
      "upper": "water",
      "lower": "fire",
      "upperToLower": "controls"
    },
    "nuclear": {
      "lowerTrigram": {
        "index": 3,
        "name": "Kan (Water)",
        "symbol": "☵",
        "lines": [
          0,
          1,
          0
        ],
        "pinyin": "Kan",
        "chinese": "坎",
        "image": "water",
        "attribute": "peril",
        "family": "middle son",
        "animal": "pig",
        "bodyPart": "ears",
        "earlierHeaven": {
          "number": 6,
          "direction": "west"
        },
        "laterHeaven": {
          "number": 1,
          "direction": "north"
        },
        "phase": "water"
      },
      "upperTrigram": {
        "index": 6,
        "name": "Li (Fire)",
        "symbol": "☲",
        "lines": [
          1,
          0,
          1
        ],
        "pinyin": "Li",
        "chinese": "離",
        "image": "fire, the sun",
        "attribute": "brightness",
        "family": "middle daughter",
        "animal": "pheasant",
        "bodyPart": "eyes",
        "earlierHeaven": {
          "number": 3,
          "direction": "east"
        },
        "laterHeaven": {
          "number": 9,
          "direction": "south"
        },
        "phase": "fire"
      },
      "hexagram": 64,
      "rule": "Lines 2-4 make the lower nuclear trigram, lines 3-5 the upper."
    },
    "inverse": {
      "hexagram": 64,
      "rule": "The figure turned upside down (zong gua).",
      "symmetric": false
    },
    "complement": {
      "hexagram": 64,
      "rule": "Every line changed to its opposite (cuo gua)."
    },
    "source": "Shuo Gua ch. 4-11 (Legge, Sacred Books of the East vol. XVI, Appendix V, 1882, public domain) for image, attribute, family, animal and body part; Fu Xi (Earlier Heaven) and King Wen (Later Heaven) arrangements for numbers and directions; Han-era five-phase correspondence."
  }
}

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"
  }
}

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

// Назад

I Ching Reading (Legge text)

Далі //

Hexagram Compatibility

Trigram Analysis

Authorizations

Parameters

Query Parameters

Example

Example

Header Parameters

Example

Request Body required

Example

Responses

200

Example

400

Example

401

Example

Request Body^required