POST/api/astro/numerology/chinese/1 crédit

Numérologie chinoise

Numérologie chinoise : la grille Lo Shu et les cinq éléments. `loshu_grid_arrows` lit les flèches de force et d’absence sur la grille 3×3 des chiffres de la date de naissance ; `five_element_balance` donne Bois, Feu, Terre, Métal et Eau en nombre d’occurrences et en pourcentage. Les nombres porte-bonheur et néfastes suivent la tradition des homophones — 8 pour la prospérité, 4 à éviter. `house_number` et `phone_number` réduisent un nombre que vous fournissez. Les deux valent 0 par défaut si vous les omettez, si bien que l’appel réussit quand même. Renvoie 9 calculs. Envoyez un nom et une date de naissance. Le système est fixé par la route : un champ `system` envoyé dans le corps est donc ignoré — cet endpoint ne peut pas renvoyer les nombres d’un autre système. L’endpoint parent /api/astro/numerology/ regroupe les 34 calculs derrière un champ `system`, et demander une clé appartenant à un autre système renvoie une erreur 400 qui fait échouer TOUTE la requête. Ces routes suppriment ce problème : chacune ne demande que les clés prises en charge par son propre système.

https://api.occultapi.com/api/astro/numerology/chinese/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Champs de la requête

Champ	Type	Obligatoire	Remarques
date_time	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes.
name	string	obligatoire
day	integer	facultatif	Jour du mois sous forme de nombre, 1-31.
house_number	string	facultatif
keys	array	facultatif	Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels.
month	integer	facultatif	Mois de naissance sous forme de nombre, 1-12. Janvier vaut 1.
phone_number	string	facultatif
system	string	facultatif
year	integer	facultatif	Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/numerology/chinese/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","name":"Ajeet Kumar","day":15,"month":8,"year":1990}'

Réponse

{
  "data": {
    "chinese_name_number": 5,
    "five_element_balance": {
      "balance": {
        "Wood": {
          "count": 0,
          "percentage": 0,
          "meaning": "Growth, creativity, flexibility",
          "associated_numbers": [
            3,
            4
          ]
        },
        "Fire": {
          "count": 2,
          "percentage": 25,
          "meaning": "Passion, energy, transformation",
          "associated_numbers": [
            9
          ]
        },
        "Earth": {
          "count": 3,
          "percentage": 37.5,
          "meaning": "Stability, nourishment, groundedness",
          "associated_numbers": [
            2,
            5,
            8
          ]
        },
        "Metal": {
          "count": 1,
          "percentage": 12.5,
          "meaning": "Strength, determination, clarity",
          "associated_numbers": [
            6,
            7
          ]
        },
        "Water": {
          "count": 2,
          "percentage": 25,
          "meaning": "Wisdom, flow, adaptability",
          "associated_numbers": [
            1
          ]
        }
      },
      "interpretation": "The Five Elements show the distribution of energy in your chart. Wood represents growth, Fire is passion, Earth is stability, Metal represents strength, and Water represents wisdom."
    },
    "house_number": 0,
    "loshu_grid_arrows": {
      "arrow_of_determination": {
        "present": true,
        "meaning": "Indicates strong willpower and determination."
      },
      "arrow_of_emotional_balance": {
        "present": false,
        "meaning": "Indicates emotional stability and balance."
      },
      "arrow_of_practicality": {
        "present": false,
        "meaning": "Indicates a practical and grounded approach to life."
      },
      "arrow_of_intellect": {
        "present": false,
        "meaning": "Indicates strong intellectual capabilities and memory."
      }
    },
    "lucky_numbers": [
      2,
      3,
      6,
      7,
      8,
      9
    ],
    "personal_life_path_number": 6,
    "phone_number": 0,
    "unlucky_numbers": [
      1,
      4,
      5,
      6
    ],
    "vedic_personal_day": 2
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.