İçeriğe atla
POST/api/astro/western/composite/1 kredi

Kompozit harita

Bir ilişkinin orta nokta haritası; kendi başına bir varlık olarak yorumlanır. Sinastri iki haritayı karşılaştırır, kompozit ise onları BİRLEŞTİRİR: her gök cismi iki kişinin konumlarının orta noktasına yerleşir ve sonuç, kişilerden birinin değil, ilişkinin kendisinin haritası olarak yorumlanır. Orta noktalar kısa yay üzerinden alınır. Yerleşik kural budur ve iki sayının ortalamasını almakla AYNI ŞEY DEĞİLDİR: 350 ve 10 derecedeki bir çiftin kompozit konumu 180 değil, 0'dır. Her gök cismi için kaynak alınan iki boylam da döner; böylece orta noktayı doğrulayabilirsiniz. Kompozit haritada hız ve retro hareket yoktur: zaman içinde bir anı temsil etmez, dolayısıyla içindeki hiçbir şey hareket etmez. Kompozit gök cisimleri arasındaki açılar ise ANLAMLIDIR ve döndürülür.

https://api.occultapi.com/api/astro/western/composite/
İ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ı

AlanTürZorunluNotlar
date_timestring (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.

partner_date_timestring (date-time)zorunlu
ayanamsastringisteğe bağlı

TROPICAL (varsayılan) veya LAHIRI, KRISHNAMURTI, RAMAN ya da FAGAN_BRADLEY gibi bir ayanamsa adı; büyük/küçük harfe duyarsızdır. Sideral bir ayanamsa seçildiğinde, ayanamsanın o andaki değeri döndürülen her boylamdan çıkarılır.

include_asteroid_lilithbooleanisteğe bağlı

(1181) Lilith asteroidini, diğer gök cisimlerinden sonra "asteroid_lilith" adıyla ekler. Bu cisim Kara Ay Lilith'ten farklıdır.

include_lilithbooleanisteğe bağlı

Kara Ay Lilith'i (ortalama Ay yerötesi), diğer gök cisimlerinden sonra "lilith" adıyla ekler.

keysarrayisteğe bağlı

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.

latitudenumber (double)isteğe bağlı

Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin.

longitudenumber (double)isteğe bağlı

Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer.

orb_factornumber (double)isteğe bağlı

Tüm açı orb'larını ölçekler. 0.5 orb'ları yarıya indirir, 2 iki katına çıkarır.

min 0.1 · max 2

partner_timezone_as_floatnumber (double)isteğe bağlı

min -12 · max 14

timezone_as_floatnumber (double)isteğe bağlı

Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir.

min -12 · max 14

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/western/composite/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"partner_date_time":"1988-11-23T07:15:00+05:30","partner_timezone_as_float":5.5,"orb_factor":1}'

Yanıt

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"zodiac\": \"tropical\", \"chart\": \"composite_midpoint\", \"orb_factor\": 1.0, \"planets\": [{\"name\": \"sun\", \"longitude\": 325.3295, \"from\": {\"person_a\": 49.66766, \"person_b\": 240.991341}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.3295, \"formatted\": \"25°19' Aquarius\"}, {\"name\": \"moon\", \"longitude\": 325.741456, \"from\": {\"person_a\": 238.259725, \"person_b\": 53.223187}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.7415, \"formatted\": \"25°44' Aquarius\"}, {\"name\": \"mercury\", \"longitude\": 317.866522, \"from\": {\"person_a\": 39.452338, \"person_b\": 236.280707}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 17.8665, \"formatted\": \"17°51' Aquarius\"}, {\"name\": \"venus\", \"longitude\": 288.321938, \"from\": {\"person_a\": 7.250368, \"person_b\": 209.393508}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 18.3219, \"formatted\": \"18°19' Capricorn\"}, {\"name\": \"mars\", \"longitude\": 354.304998, \"from\": {\"person_a\": 344.690843, \"person_b\": 3.919152}, \"sign\": \"Pisces\", \"sign_index\": 12, \"degree_in_sign\": 24.305, \"formatted\": \"24°18' Pisces\"}, {\"name\": \"jupiter\", \"longitude\": 79.84236, \"from\": {\"person_a\": 98.630274, \"person_b\": 61.054447}, \"sign\": \"Gemini\", \"sign_index\": 3, \"degree_in_sign\": 19.8424, \"formatted\": \"19°50' Gemini\"}, {\"name\": \"saturn\", \"longitude\": 283.210836, \"from\": {\"person_a\": 295.313114, \"person_b\": 271.108557}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 13.2108, \"formatted\": \"13°12' Capricorn\"}, {\"name\": \"uranus\", \"longitude\": 274.377978, \"from\": {\"person_a\": 279.296197, \"person_b\": 269.459759}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 4.378, \"formatted\": \"4°22' Capricorn\"}, {\"name\": \"neptune\", \"longitude\": 281.474487, \"from\": {\"person_a\": 284.419553, \"person_b\": 278.52942}, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 11.4745, \"formatted\": \"11°28' Capricorn\"}, {\"name\": \"pluto\", \"longitude\": 224.774448, \"from\": {\"person_a\": 226.304012, \"person_b\": 223.244883}, \"sign\": \"Scorpio\", \"sign_index\": 8, \"degree_in_sign\": 14.7744, \"formatted\": \"14°46' Scorpio\"}, {\"name\": \"north_node\", \"longitude\": 325.694721, \"from\": {\"person_a\": 310.874753, \"person_b\": 340.514689}, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 25.6947, \"formatted\": \"25°41' Aquarius\"}, {\"name\": \"chiron\", \"longitude\": 99.523745, \"from\": {\"person_a\": 102.832128, \"person_b\": 96.215362}, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 9.5237, \"formatted\": \"9°31' Cancer\"}], \"count\": 29, \"aspects\": [{\"from\": \"moon\", \"to\": \"north_node\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.0467, \"separation\": 0.0467}, {\"from\": \"sun\", \"to\": \"north_node\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.3652, \"separation\": 0.3652}, {\"from\": \"sun\", \"to\": \"moon\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 0.412, \"separation\": 0.412}, {\"from\": \"mercury\", \"to\": \"venus\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 0.4554, \"separation\": 29.5446}, {\"from\": \"sun\", \"to\": \"mars\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.0245, \"separation\": 28.9755}, {\"from\": \"mars\", \"to\": \"north_node\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.3897, \"separation\": 28.6103}, {\"from\": \"moon\", \"to\": \"mars\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.4365, \"separation\": 28.5635}, {\"from\": \"venus\", \"to\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.5204, \"separation\": 151.5204}, {\"from\": \"saturn\", \"to\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 1.5636, \"separation\": 58.4364}, {\"from\": \"saturn\", \"to\": \"neptune\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 1.7363, \"separation\": 1.7363}, {\"from\": \"neptune\", \"to\": \"chiron\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 1.9507, \"separation\": 178.0493}, {\"from\": \"mercury\", \"to\": \"jupiter\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 1.9758, \"separation\": 121.9758}, {\"from\": \"mercury\", \"to\": \"pluto\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 3.0921, \"separa"
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında 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.