POST/api/astro/numerology/1 kredi

Numeroloji

Numeroloji bir adı ve doğum tarihini tek basamaklı sayılara indirger ve bu sayıları yorumlar. Bu endpoint, system ile seçilen dört sistemi destekler; her sistemin kendi harf tablosu ve kendi anahtar kümesi vardır. 'chaldean' (varsayılan) ve 'pythagorean' Batı sistemleridir ve on altı anahtarı ortak kullanır — yaşam yolu, ifade, ruh dürtüsü, kişilik ve diğerleri. İkisi harf değerlerinde ve bilinmesi gereken bir davranışta ayrılır: Pisagor sistemi 11 ve 22 usta sayılarını korur, Keldani sistemi ise her zaman tek basamağa indirger. Bu yüzden expression_number, soul_urge_number, maturity_number ve life_path_number yalnızca Pisagor sisteminde 11 veya 22 olarak dönebilir. Pisagor sistemi ayrıca kendine özgü üç anahtar ekler: pinnacle_cycles, balance_number ve rational_thought. 'chinese' ve 'vedic' ayrı kümelerdir ve Çin sisteminin de kabul ettiği personal_year_number dışında ortak anahtarları yoktur. Seçilen sistemde olmayan bir anahtar istenirse istek, sorunlu anahtarın adını belirten HTTP 400 ile reddedilir. Her çağrıda date_time ve name gönderin. year, month ve day, kişisel yıl, ay ve gün anahtarlarının hedef tarihidir ve varsayılan olarak bugünü alır; house_number ve phone_number yalnızca bu anahtarlar istendiğinde zorunludur. Yanıtta her anahtarın sonucunun yanında, o anahtarın girdisini, formülünü ve anlamını veren bir <key>_metadata nesnesi ve ayrıca vedic_planet_associations ya da Çin sistemi için chinese_number_meanings bulunur.

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

İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

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

İstek alanları

Alan	Tür	Zorunlu	Notlar
date_time	string (date-time)	zorunlu	Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir.
keys	array	zorunlu	Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin. Hangi anahtarların kullanılabileceği `system` değerine bağlıdır. Keldani ve Pisagor sistemleri on altı anahtarı ortak kullanır; Pisagor sistemi bunlara pinnacle_cycles, balance_number ve rational_thought anahtarlarını ekler; Çin ve Vedik sistemlerinin kendi kümeleri vardır ve başka anahtar kabul etmezler. Seçilen sistemde olmayan bir anahtar istenirse, sorunlu anahtarın adını belirten bir 400 döner.
name	string	zorunlu
day	integer	isteğe bağlı	Ayın günü, 1-31 arası bir sayı olarak.
house_number	string	isteğe bağlı	Ev veya daire numarası. Yalnızca 'keys' içinde 'house_number' varsa zorunlu.
month	integer	isteğe bağlı	Doğum ayı, 1-12 arası bir sayı olarak. Ocak 1'dir.
phone_number	string	isteğe bağlı	Tam telefon numarası. Yalnızca 'keys' içinde 'phone_number' varsa zorunlu.
system	string	isteğe bağlı	Kullanılacak numeroloji sistemi. Not: Keldani, Pisagor, Çin ve Vedik sistemleri desteklenir. `chaldeanpythagoreanchinesevedic`
year	integer	isteğe bağlı	Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı.

Kullanılabilir anahtarlar (34)

İstediğiniz hesaplamaları keys içinde tek tek sayın; yalnızca onlar hesaplanır. Bilinmeyen tek bir anahtar bile isteğin tamamını reddettirir. Kaç anahtar isterseniz isteyin ücret 1 kredi olur; bu yüzden hepsini tek istekte toplayın.

Anahtar	Gereken ek alanlar	Açıklama
balance_number	—	Addaki her kelimenin baş harfi sayıya çevrilir, toplanır ve indirgenir — stres altında başvurulan iç kaynak. 1-9 arası tek bir tam sayı. Yalnızca Pisagor sistemi.
bhagyank	—	Vedik kader sayısı: DDMMYYYY biçiminde yazılan doğum tarihinin sekiz rakamı toplanır ve indirgenir. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem.
birthday_number	—	psychic_number ile aynı değeri döndürür — tek basamağa indirgenmiş doğum günü; 1-9 arası tek bir tam sayı. Bu, doğum günü sayısının indirgenmemiş gün (1-31) olarak alındığı yaygın kullanımdan farklıdır. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
bridge_number	—	Kim olduğunuz ile ne yaptığınız arasındaki mesafe: indirgenmiş yaşam yolu sayısı ile indirgenmiş ifade sayısı arasındaki mutlak fark. 0-8 arası tek bir tam sayı; değer küçüldükçe ikisi birbirine yaklaşır. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
challenge_number	—	İndirgenmiş doğum ayı ile indirgenmiş doğum günü arasındaki mutlak fark. 0-8 arası tek bir tam sayı. Bazı sistemlerin ürettiği dört zorluk sayısını değil, tek bir sayı döndürdüğüne dikkat edin. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
chinese_name_number	—	Ad, Batı harf tablosu yerine pinyin ses tablosuyla puanlanır ve indirgenir. Çince karakterler küçük bir soyadı tablosunda aranır (tabloda olmayan karakterler için yedek bir değer kullanılır), Latin harfleri ise pinyin eşlemesiyle değerlendirilir. 1-9 arası tek bir tam sayı. Yalnızca Çin sistemi.
compound_meaning	—	Bileşik sayının klasik adı; 10 ile 52 arasını kapsayan bir tablodan alınır — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' vb. Tek bir string döner; bileşik toplam 10-52 dışında kalırsa (uzun adlarda sık görülür) 'No specific meaning defined' döner. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
compound_number	—	Tam addaki tüm harflerin, seçilen sistemin tablosuna göre indirgenmemiş toplamı — compound_meaning anahtarının tabloda aradığı sayı. Tek bir tam sayı; adın uzunluğuna göre genellikle yirmi ile iki yüz arasındadır. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
expression_number	—	Kader sayısı: tam addaki her harf seçilen sistemin harf tablosuyla sayıya çevrilir, toplanır ve indirgenir. Tek bir tam sayı — Keldani sisteminde her zaman 1-9; usta sayıları koruyan Pisagor sisteminde ise 1-9 ya da 11 veya 22 usta sayıları. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
five_element_balance	—	Doğum tarihindeki rakamların, yaşam yolu sayısının ve Çince ad sayısının beş elemente dağılımı. {balance, interpretation} döndürür; balance nesnesinin anahtarları Wood, Fire, Earth, Metal ve Water'dır ve her öğe {count, percentage, meaning, associated_numbers} yapısındadır. Wood 3 ve 4'ü, Fire 9'u, Earth 2, 5 ve 8'i, Metal 6 ve 7'yi, Water 1'i alır; sıfırlar hiçbir elemente sayılmaz. Yalnızca Çin sistemi.
growth_number	—	Doğum günü ile doğum ayının toplamı, indirgenmiş olarak. 1-9 arası tek bir tam sayı. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
hidden_passion_number	—	Tam adda en sık geçen harf değeri — adın sürekli yinelediği yetenek. Tek bir tam sayı; en sık geçen birden fazla değer varsa en küçüğü döndürülür, ad puanlanabilir harf içermiyorsa 0 döner. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
house_number	house_number	house_number alanında gönderilen ev veya daire numarasının rakamları toplanır ve tek basamağa indirgenir. 1-9 arası tek bir tam sayı ya da değer hiç rakam içermiyorsa 0. Yalnızca Çin sistemi; bu anahtar istendiğinde istek alanı zorunludur.
karmic_debt_numbers	—	Tam adda hiç geçmeyen harf değerleri — çoğu sistem bunlara karmik borç değil, karmik ders der. Eksik değerlerin listesini döndürür: Keldani sisteminde (tablosunda 9 yoktur) 1-8, Pisagor sisteminde 1-9 arasından. Klasik 13/14/16/19 borç sayılarını döndürmez. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
life_path_number	—	Doğum günü, ayı ve yılı ayrı ayrı indirgenir, toplanır ve yeniden indirgenir. Tek bir tam sayı; Pisagor sisteminde 11 ve 22 korunur. Tarihin ham rakamlarını toplayan ve bu yüzden farklı sonuç verebilen personal_life_path_number ve bhagyank ile karşılaştırın. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
loshu_grid_arrows	—	Dört Lo Shu oku; her çizginin üç rakamının da doğum tarihinde bulunup bulunmadığına bakılarak belirlenir. Anahtarları arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) ve arrow_of_intellect (3-6-9) olan bir nesne döndürür; her biri {present, meaning} yapısındadır. Yalnızca okların varlığı bildirilir; boş oklar ayrı bir bulgu sayılmaz. Yalnızca Çin sistemi.
lucky_numbers	—	Doğum yılına karşılık gelen Çin burcu hayvanının şanslı sayıları ile genel olarak uğurlu kabul edilen 8, 6 ve 9 birleştirilir. Birbirinden farklı tam sayılardan oluşan, genellikle dört ila altı öğeli sıralı bir liste döndürür. Yalnızca Çin sistemi.
maturity_number	—	İfade sayısı ile yaşam yolu sayısının toplamı, indirgenmiş olarak. Tek bir tam sayı; Pisagor sisteminde 11 ve 22 korunur. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
moolank	—	Vedik psişik sayı: tek basamağa indirgenmiş doğum günü. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem; değeri psychic_number ile aynıdır.
namank	—	Vedik ad sayısı: tam ad Keldani harf tablosuyla puanlanır ve indirgenir. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem; diğer ayarlardan bağımsız olarak her zaman Keldani tablosunu kullanır.
name_number	—	Yalnızca ilk ad — ilk boşluğa kadar olan kısım — seçilen harf tablosuyla sayıya çevrilir, toplanır ve indirgenir. 1-9 arası tek bir tam sayı; Pisagor sisteminde bile burada usta sayılar korunmaz. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
personal_life_path_number	—	DDMMYYYY biçiminde yazılan doğum tarihinin tüm rakamları toplanır ve tek basamağa indirgenir. 1-9 arası tek bir tam sayı. Yalnızca Çin sistemi; Vedik bhagyank anahtarı da aynı değeri hesaplar.
personal_year_number	year	Belirli bir takvim yılının teması: doğum günü, doğum ayı ve hedef yıl önce ayrı ayrı indirgenir, sonra toplanıp yeniden indirgenir. year alanını kullanır; varsayılan değer içinde bulunulan yıldır. 1-9 arası tek bir tam sayı; her sistemde kullanılabilen tek anahtardır.
personality_number	—	Tam addaki ünsüzlerin toplamı, indirgenmiş olarak — soul_urge_number iç dünyayı, bu sayı ise dışarıya verilen izlenimi gösterir. 1-9 arası tek bir tam sayı; hiçbir zaman usta sayı olmaz. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
phone_number	phone_number	phone_number alanında gönderilen telefon numarasının rakamları toplanır ve indirgenir. 1-9 arası tek bir tam sayı ya da hiç rakam yoksa 0. Yalnızca Çin sistemi; bu anahtar istendiğinde alan zorunludur.
pinnacle_cycles	—	Dört zirve: Pisagor numerolojisinde art arda gelen yaşam evreleri; indirgenmiş doğum ayı, günü ve yılından hesaplanır. {first, second, third, fourth} döndürür; her biri 11 ve 22'yi koruyan bir tam sayıdır. Yalnızca Pisagor sistemi.
psychic_number	—	Kök ya da psişik sayı: doğum gününün (ayın kaçında doğulduğunun) tek basamağa indirgenmiş hâli. 1-9 arası tek bir tam sayı. Yalnızca Keldani ve Pisagor sistemleri.
rational_thought	—	İlk adın harf toplamı ile doğum gününün toplamı, indirgenmiş olarak — kişinin bir sorunu nasıl düşünerek çözdüğünü gösterdiği kabul edilir. 1-9 arası tek bir tam sayı. Yalnızca Pisagor sistemi.
soul_urge_number	—	Kalp arzusu sayısı: tam addaki yalnızca ünlü harfler toplanır ve indirgenir. Tek bir tam sayı; Pisagor sisteminde 11 ve 22 korunur. A, E, I, O ve U sayılır; Y sayılmaz. `system` değeri `chaldean` veya `pythagorean` olduğunda kullanılabilir; diğer sistemler 400 döndürür.
unlucky_numbers	—	Aynı burç hayvanının şanssız sayıları, 4 ile birleştirilerek. Birbirinden farklı tam sayılardan oluşan sıralı bir liste döndürür. Yalnızca Çin sistemi.
vedic_grid	—	Gezegen yöneticileriyle birlikte 3×3 doğum ızgarası. {grid, grid_layout, details} döndürür: grid_layout sabit [[4,9,2],[3,5,7],[8,1,6]] düzenidir; grid, bu rakamların her birinin doğum tarihinde kaç kez geçtiğini aynı konumlarda tutar; details ise '1' ile '9' arası anahtarlarla {planet, meaning, count, active} öğelerini içerir. Yalnızca Vedik sistem.
vedic_personal_day	year, month, day	Kişisel gün: ((Vedik kişisel ay + hedef gün − 1) mod 9) + 1. year, month ve day alanlarını kullanır; her birinin varsayılanı bugündür. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem.
vedic_personal_month	year, month	Kişisel ay: ((Vedik kişisel yıl + hedef ay − 1) mod 9) + 1. year ve month alanlarını kullanır; her birinin varsayılanı bugündür. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem.
vedic_personal_year	year	Vedik formüle göre kişisel yıl: ((doğum günü + doğum ayı + hedef yıl − 1) mod 9) + 1. Değerleri önce tek tek indirgemek yerine ham hâlleriyle topladığına dikkat edin; bu yüzden aynı kişi ve yıl için personal_year_number değerinden farklı çıkabilir. year alanını kullanır; varsayılan değer içinde bulunulan yıldır. 1-9 arası tek bir tam sayı. Yalnızca Vedik sistem.

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/numerology/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01T06:00:00+05:30","name":"Ramesh Kumar","day":1,"month":9,"year":2026,"system":"chaldean","keys":["birthday_number","expression_number","life_path_number"]}'

Yanıt

{
  "data": {
    "birthday_number": 1,
    "expression_number": 8,
    "life_path_number": 2,
    "birthday_number_metadata": {
      "name": "Birthday Number",
      "input": "Day of Birth (DD)",
      "formula": "Use the day directly if it's a single digit; if it's a double-digit number, reduce to a single digit.",
      "meaning": "Reveals natural talents and key characteristics based on birthdate."
    },
    "expression_number_metadata": {
      "name": "Expression Number (Destiny Number)",
      "input": "Full Name (Chaldean letter chart)",
      "formula": "Sum the values of all letters based on Chaldean chart and reduce to a single digit.",
      "meaning": "Reflects overall potential and life path, linked to name vibration."
    },
    "vedic_planet_associations": {
      "1": {
        "planet": "Sun (Surya)",
        "meaning": "Leadership, authority, soul, father"
      },
      "2": {
        "planet": "Moon (Chandra)",
        "meaning": "Mind, emotions, mother, intuition"
      },
      "3": {
        "planet": "Jupiter (Guru)",
        "meaning": "Wisdom, knowledge, expansion, teacher"
      },
      "4": {
        "planet": "Rahu (North Node)",
        "meaning": "Illusion, material desires, sudden changes"
      },
      "5": {
        "planet": "Mercury (Buddh)",
        "meaning": "Communication, intellect, business, speech"
      },
      "6": {
        "planet": "Venus (Shukra)",
        "meaning": "Love, luxury, arts, relationships"
      },
      "7": {
        "planet": "Ketu (South Node)",
        "meaning": "Spirituality, detachment, intuition, moksha"
      },
      "8": {
        "planet": "Saturn (Shani)",
        "meaning": "Discipline, karma, hard work, delays"
      },
      "9": {
        "planet": "Mars (Mangal)",
        "meaning": "Energy, courage, action, aggression"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında, istediğiniz her anahtarın adıyla yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.