POST/api/astro/porutham/1 crédit

Porutham (compatibilité sud-indienne)

Compatibilité de mariage sud-indienne : les douze poruthams en un seul appel. Indiquez le nakshatra de naissance (1-27) et le pada (1-4) des deux partenaires. Chaque porutham est renvoyé avec son résultat traditionnel et sa variante sud-indienne, côte à côte. C’est un système DIFFÉRENT du gun milan Ashtakoota nord-indien, que fournit /api/astro/ashtakoota/. Les deux partent des deux mêmes nakshatras de naissance mais ne retiennent pas les mêmes critères : choisissez donc celui de votre tradition — la compatibilité tamoule, télougoue et kannada repose sur ces poruthams. Aucune heure ni aucun lieu de naissance n’est nécessaire, et ce n’est pas une simplification : le porutham s’évalue à partir du nakshatra et de son quart, si bien qu’une date serait une donnée que le calcul ne lit jamais.

https://api.occultapi.com/api/astro/porutham/

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
boy_nakshatra_number	integer	obligatoire	min 1 · max 27
boy_paadham_number	integer	obligatoire	min 1 · max 4
girl_nakshatra_number	integer	obligatoire	min 1 · max 27
girl_paadham_number	integer	obligatoire	min 1 · max 4
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.
method	string	facultatif
nakshatra_number	integer	facultatif
paadha_number	integer	facultatif
use_astroyogi_method	boolean	facultatif

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/porutham/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boy_nakshatra_number":5,"boy_paadham_number":3,"girl_nakshatra_number":12,"girl_paadham_number":2}'

Réponse

{
  "data": {
    "system": "porutham",
    "count": 12,
    "poruthams": [
      {
        "porutham": "varna",
        "traditional": [
          0,
          1
        ],
        "south_indian": null,
        "has_south_variant": false
      },
      {
        "porutham": "vasiya",
        "traditional": [
          1,
          2
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "dina",
        "traditional": [
          3,
          3
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "gana",
        "traditional": [
          6,
          6
        ],
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "yoni",
        "traditional": [
          1,
          4
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "raasi_adhipathi",
        "traditional": [
          5,
          5
        ],
        "south_indian": 0,
        "has_south_variant": true
      },
      {
        "porutham": "raasi",
        "traditional": [
          7,
          7
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "naadi",
        "traditional": [
          8,
          8
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "mahendra",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "vedha",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "rajju",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "sthree_dheerga",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": true
      }
    ]
  },
  "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.