Temel URL: https://api.natalchart.ai. Her istek bir API anahtarı taşır, her yanıt JSON'dur ve her boylam, burca dönüştürülmeden önce derecenin dört ondalık basamağına kadar verilir. Anahtar ücretsizdir: bir NatalChart.AI hesabıyla giriş yapın ve uygulama ayarlarındaki API & MCP sekmesinden bir anahtar oluşturun.
Hızlı başlangıç
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'Sitenin genelinde kullanılan örnek doğum verisi (1991-09-06, saat 18:30, Kiev) için yanıt. Gök cisimlerinden beşi gösteriliyor:
{
"sun": {
"sign": "Virgo",
"degreeInSign": 13.55,
"house": 7
},
"moon": {
"sign": "Leo",
"degreeInSign": 19.02,
"house": 7
},
"ascendant": {
"sign": "Aquarius",
"degreeInSign": 14.9898
},
"signs": {
"Sun": "Virgo",
"Moon": "Leo",
"Mercury": "Leo",
"Venus": "Leo",
"Mars": "Libra"
},
"retrograde": [
"Venus",
"Saturn",
"Uranus",
"Neptune",
"TrueNode",
"Lilith",
"Juno"
]
}Kod örnekleri
Aynı istek JavaScript, Python ve PHP ile. Herhangi bir HTTP istemcisi kullanılabilir; OpenAPI belgesi ise istemciyi sizin yerinize bir kod üreticisinin yazmasını sağlar.
JavaScript
const res = await fetch("https://api.natalchart.ai/v1/chart/short", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.NATALCHART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ birth: { date: "1991-09-06", time: "18:30", latitude: 50.4501, longitude: 30.5234 } }),
});
const chart = await res.json();Python
import os, requests
res = requests.post(
"https://api.natalchart.ai/v1/chart/short",
headers={"Authorization": f"Bearer {os.environ['NATALCHART_API_KEY']}"},
json={"birth": {"date": "1991-09-06", "time": "18:30", "latitude": 50.4501, "longitude": 30.5234}},
)
chart = res.json()PHP
$ch = curl_init("https://api.natalchart.ai/v1/chart/short");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("NATALCHART_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["birth" => ["date" => "1991-09-06", "time" => "18:30", "latitude" => 50.4501, "longitude" => 30.5234]]),
]);
$chart = json_decode(curl_exec($ch), true);Yapay zekâ asistanları için MCP sunucusu
Aynı hesaplamalar, Claude, ChatGPT, Cursor ve VS Code için https://www.natalchart.ai/mcp adresinde bir MCP sunucusu olarak sunulur. Sunucu aynı anahtarla çalışır ve aynı günlük havuzdan harcar: her araç çağrısı bir istektir. Her istemci için kurulum: Yapay zekâ asistanları için MCP sunucusu.
Kimlik doğrulama
Anahtarı Authorization: Bearer nc_live_... olarak gönderin (X-API-Key başlığı da çalışır). Anahtarın tamamı yalnızca bir kez, oluşturduğunuzda gösterilir; biz yalnızca hash değerini saklarız. Bir hesapta en fazla beş etkin anahtar bulunabilir ve bunlardan herhangi biri anında iptal edilebilir. Anahtarları bir sunucuda tutun: tarayıcı ya da uygulama koduyla dağıtılan bir anahtarı herkes okuyabilir.
Doğum verileri
Harita hesaplayan uç noktalar tek bir nesne alır:
{
"birth": {
"date": "1991-09-06",
"time": "18:30",
"latitude": 50.4501,
"longitude": 30.5234,
"timezone": "Europe/Kyiv"
}
}| Alan | Zorunlu | Anlamı |
|---|---|---|
date | evet | Doğum tarihi, YYYY-MM-DD biçiminde, 1800 ile 2399 arası. |
time | hayır | Yerel saat, HH:mm biçiminde, 24 saat düzeninde. Bilinmiyorsa null. |
latitude, longitude | evet | Ondalık derece; kuzey ve doğu pozitif. |
timezone | hayır | IANA saat dilimi. Belirtilmezse koordinatlardan, o tarihteki yaz saati kurallarıyla belirlenir. |
Uç noktalar
| Uç nokta | Plan | Döndürdüğü |
|---|---|---|
POST /v1/chart/short | Ücretsiz | Kısa harita: dereceleriyle Güneş, Ay ve yükselen; her gök cisminin burcu, retro gök cisimleri, baskın element ve nitelik. |
POST /v1/chart/full | Ücretsiz | Tam harita: boylamı, burcu, derecesi, hızı, retro bayrağı ve eviyle her gök cismi; köşe noktaları; on iki Placidus ev başlangıcı; orblarıyla açılar; element ve nitelik dengesi; sabit yıldız temasları. |
POST /v1/chart/planets | Ücretsiz | Yalnızca gök cisimleri: boylam, burç, burç içindeki derece, günlük hız, retro bayrağı, ev. |
POST /v1/chart/angles | Ücretsiz | Yükselen, Tepe Noktası (MC), Vertex ve Şans Noktası. |
POST /v1/chart/houses | Ücretsiz | On iki Placidus ev başlangıcı. |
POST /v1/chart/aspects | Ücretsiz | Gök cisimleri arasındaki beş majör açı, her birinin açı değeri ve orbuyla birlikte; ayrıca kullanılan orb tablosu. |
POST /v1/chart/elements | Ücretsiz | Element ve nitelik dengesi, baskın element ve nitelikle birlikte. |
POST /v1/chart/fixed-stars | Ücretsiz | Natal gök cisimleriyle 1,5 derece içindeki sabit yıldız kavuşumları. |
POST /v1/horoscope/daily | Ücretsiz | Hesaplanmış gün: UTC'ye göre öğle vaktindeki gökyüzü, Ay'ın evresi, önümüzdeki haftanın gökyüzü olayları ve doğum verileri verilirse natal haritaya yapılan her transit, orbuyla birlikte. Üretilmiş metin yok. |
GET /v1/sky | Ücretsiz | Bir tarih için gezegen konumları, Ay evresi ve önümüzdeki haftanın gökyüzü olayları (?date=YYYY-MM-DD; varsayılan olarak bugün). Anahtar olmadan çalışır. |
GET /v1/usage | Ücretsiz | Planınız, bugünkü istek sayınız ve havuzun ne zaman yenileneceği. Hiçbir şeye mal olmaz. |
POST /v1/transits | Premium ve MAX | En fazla 92 günlük bir aralıkta 60'a kadar transit olayı (daha fazlası varsa en önemlileri tutulur): tarihe göre natal haritaya tam transit açıları, burca girişler ve durağanlıklar. |
POST /v1/synastry | Premium ve MAX | İki haritanın karşılaştırması: orblarıyla haritalar arası açılar, iki yönlü ev bindirmeleri ve yaşam alanı başına bir puan. |
POST /v1/solar-return | Premium ve MAX | Bir yılın Güneş dönüşü haritası; doğum yeri ya da başka bir konum için kurulur. |
POST /v1/timing | Premium ve MAX | En fazla 62 günlük bir aralığın her günü, tek bir etkinlik (general, business, romance, health, creative, travel, home, clarity) için puanlanır: destekleyen ve engelleyen transitler, Ay'ın evresi ve burcu, Ay'ın boşlukta olup olmadığı. En iyi beş gün en başta gelir. |
POST /v1/locations/score | Premium ve MAX | Tek bir yer, tek bir haritaya göre: taşınmış haritanın köşe noktaları, bunların üzerindeki gezegenler ve orbları, her yaşam alanı için bir puan ve genel bir puan. |
POST /v1/locations/rank | Premium ve MAX | Büyük şehirlerden oluşan kataloğun tek bir haritaya göre sıralanması; genel olarak ya da seçilen yaşam alanlarına göre, dünya genelinde ya da tek bir bölgede. |
Tam harita
POST /v1/chart/full hesaplamanın tamamını yayımlanan örnek dosyayla aynı yapıda döndürür; böylece herhangi bir kod yazmadan önce bir yanıtı sabit bir haritayla karşılaştırabilirsiniz. Burada iki gök cismine, iki ev başlangıcına ve en sıkı iki açıya kısaltılmıştır:
{
"input": {
"date": "1991-09-06",
"time": "18:30",
"latitude": 50.4501,
"longitude": 30.5234,
"timeKnown": true
},
"time": {
"timezone": "Europe/Kyiv",
"offsetHours": 3,
"julianDayUT": 2448506.1458333335
},
"planets": [
{
"name": "Sun",
"longitude": 163.5457,
"sign": "Virgo",
"degreeInSign": 13.55,
"speed": 0.9704,
"retrograde": false,
"house": 7
},
{
"name": "Moon",
"longitude": 139.0225,
"sign": "Leo",
"degreeInSign": 19.02,
"speed": 14.5955,
"retrograde": false,
"house": 7
}
],
"angles": {
"ascendant": {
"longitude": 314.9898,
"sign": "Aquarius"
},
"midheaven": {
"longitude": 249.8956,
"sign": "Sagittarius"
}
},
"houses": [
{
"number": 1,
"cusp": 314.9898,
"sign": "Aquarius"
},
{
"number": 2,
"cusp": 13.7492,
"sign": "Aries"
}
],
"aspects": [
{
"planet1": "Pallas",
"planet2": "Juno",
"aspect": "Square",
"angle": 89.79,
"orb": 0.21,
"phase": "separating"
},
{
"planet1": "Pluto",
"planet2": "TrueNode",
"aspect": "Sextile",
"angle": 59.57,
"orb": 0.43,
"phase": "separating"
}
],
"elements": {
"Fire": 7,
"Earth": 6,
"Air": 4,
"Water": 2
},
"qualities": {
"Cardinal": 6,
"Fixed": 11,
"Mutable": 2
}
}Bölüm uç noktaları (planets, angles, houses, aspects, elements, fixed-stars), yalnızca o bölüme ihtiyaç duyan istemciler için aynı nesnenin birer bölümünü döndürür.
Günlük burç yorumu
POST /v1/horoscope/daily, günlük burç yorumunun hesaplanan yarısıdır: UTC'ye göre öğle vaktindeki gökyüzü, Ay'ın evresi ve burcu, önümüzdeki haftanın gökyüzü olayları ve birth gönderdiğinizde o haritaya yapılan her transit; her biri açısıyla, orbuyla, yaklaşan mı ayrılan mı olduğuyla, tam olduğu anla ve transit gök cisminin bulunduğu natal evle birlikte. Transit orbu Ay, Güneş, Merkür, Venüs ve Mars için 2°, daha yavaş gök cisimleri için 3° olarak alınır. İki alan astronomi değil, sabit kurallardır ve yanıt bunu belirtir: tone (üçgen ve altmışlık için supportive, kare ve karşıtlık için challenging, kavuşum için intensifying) ve focus, yani gezegen hızına ve sıkılığa göre en üst sırada yer alan üç temas. Yazılı metin yoktur; o kısım size kalır.
Örnek harita için 2026-09-18 tarihine ait gerçek bir yanıt; listeler iki öğeye kısaltılmıştır:
{
"date": "2026-09-18",
"computedFor": "2026-09-18T12:00:00.000Z",
"moon": {
"phase": "First Quarter",
"illumination": 46.5,
"elongation": 86.04,
"sign": "Sagittarius",
"longitude": 261.6344,
"degreeInSign": 21.63,
"theme": "Decision + Action",
"nextNewMoon": {
"utc": "2026-10-10T15:50:05.436Z",
"sign": "Libra",
"degreeInSign": 17.36,
"absoluteDegree": 197.36
},
"nextFullMoon": {
"utc": "2026-09-26T16:49:02.781Z",
"sign": "Aries",
"degreeInSign": 3.62,
"absoluteDegree": 3.62
}
},
"positions": [
{
"name": "Sun",
"longitude": 175.5994,
"sign": "Virgo",
"degreeInSign": 25.6,
"speed": 0.9761,
"retrograde": false
},
{
"name": "Moon",
"longitude": 261.6344,
"sign": "Sagittarius",
"degreeInSign": 21.63,
"speed": 11.8869,
"retrograde": false
}
],
"events": [
{
"kind": "ingress",
"at": "2026-09-23T00:05:13.524Z",
"planet": "sun",
"sign": "Libra",
"degreeInSign": 0.01
},
{
"kind": "equinox",
"at": "2026-09-23T00:05:13.524Z",
"planet": "sun",
"sign": "Libra",
"degreeInSign": 0.01
}
],
"transits": [
{
"transit": "Vesta",
"natal": "Mercury",
"aspect": "Trine",
"angle": 119.93,
"orb": 0.07,
"phase": "applying",
"exactAt": "2026-09-18T21:43:39.997Z",
"tone": "supportive",
"transitHouse": 2,
"houseTheme": "Money & Possessions"
},
{
"transit": "Uranus",
"natal": "Lilith",
"aspect": "Trine",
"angle": 119.86,
"orb": 0.14,
"phase": "separating",
"exactAt": null,
"tone": "supportive",
"transitHouse": 3,
"houseTheme": "Communication & Learning"
}
],
"focus": [
{
"transit": "Pluto",
"natal": "Mars",
"aspect": "Trine",
"angle": 119.78,
"orb": 0.22,
"phase": "separating",
"exactAt": "2026-09-03T17:58:04.996Z",
"tone": "supportive",
"transitHouse": 12,
"houseTheme": "Spirituality & Subconscious"
},
{
"transit": "Neptune",
"natal": "Mars",
"aspect": "Opposition",
"angle": 179.74,
"orb": 0.26,
"phase": "separating",
"exactAt": "2026-09-09T00:24:29.005Z",
"tone": "challenging",
"transitHouse": 1,
"houseTheme": "Identity & Self"
},
{
"transit": "Jupiter",
"natal": "Moon",
"aspect": "Conjunction",
"angle": 1.77,
"orb": 1.77,
"phase": "applying",
"exactAt": "2026-09-27T20:40:07.004Z",
"tone": "intensifying",
"transitHouse": 7,
"houseTheme": "Partnerships & Marriage"
}
]
}Premium ve MAX uç noktaları
Altı uç nokta; hepsi birlikte uygulamanın hesapladığı her şeyi kapsar. Aşağıdaki yanıtların her biri, örnek harita için verilmiş gerçek bir yanıtın kısaltılmış hâlidir; bir istekteki "...", yukarıda gösterilen doğum nesnesinin yerine geçer.
Bir dönemin transitleri
POST /v1/transits uç noktası birth, from ve to alanlarını (en fazla 92 gün) alır ve aralıktaki 60'a kadar olayı döndürür (daha fazlası varsa en önemlileri tutulur): tarihe göre natal haritaya tam transit açıları, burca girişler ve durağanlıklar, tarih sırasıyla. Ayrıca ilk gün etkin olan temasları, evreleri ve tam oldukları anla birlikte verir.
{
"window": {
"from": "2026-09-18",
"to": "2026-10-18"
},
"events": [
{
"kind": "aspect",
"at": "2026-09-19T10:10:33.151Z",
"date": "2026-09-19",
"position": "14°06′ Libra",
"house": 8,
"body": "Mercury",
"target": "Neptune",
"aspect": "Square",
"exactness": 0,
"targetPosition": "14°06′ Capricorn",
"targetHouse": 11,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-22T09:53:49.800Z",
"date": "2026-09-22",
"position": "18°00′ Leo",
"house": 7,
"body": "Jupiter",
"target": "Pluto",
"aspect": "Square",
"exactness": 0,
"targetPosition": "18°00′ Scorpio",
"targetHouse": 8,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-23T20:47:58.234Z",
"date": "2026-09-23",
"position": "0°51′ Libra",
"house": 7,
"body": "Sun",
"target": "Saturn",
"aspect": "Trine",
"exactness": 0,
"targetPosition": "0°51′ Aquarius",
"targetHouse": 12,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-26T12:58:36.996Z",
"date": "2026-09-26",
"position": "3°28′ Libra",
"house": 7,
"body": "Sun",
"target": "Mars",
"aspect": "Conjunction",
"exactness": 0,
"targetPosition": "3°28′ Libra",
"targetHouse": 7,
"significance": "low"
}
]
}Sinastri
POST /v1/synastry uç noktası personA ve personB alanlarını alır ve orblarıyla haritalar arası açıları, her kişinin gezegenlerinin diğerinin hangi evlerine düştüğünü ve altı yaşam alanının her biri için bir puanı döndürür. Buradaki ikinci kişi de kurgusaldır (1989-03-14, saat 07:45, New York).
{
"aspects": [
{
"personA": "Neptune",
"personB": "Lilith",
"aspect": "Trine",
"angle": 120.08,
"orb": 0.08
},
{
"personA": "Saturn",
"personB": "Jupiter",
"aspect": "Trine",
"angle": 119.66,
"orb": 0.34
},
{
"personA": "Mercury",
"personB": "Moon",
"aspect": "Sextile",
"angle": 60.38,
"orb": 0.38
}
],
"sphereScores": {
"identity": 89,
"love": 81,
"body": 86,
"money": 76,
"home": 83,
"mind": 66
}
}Güneş dönüşü
POST /v1/solar-return uç noktası birth, year ve isteğe bağlı location alanlarını alır; Güneş'in natal boylamına döndüğü tam anı ve bu an için kurulan tam haritayı döndürür. Doğum saati gerektirir: saat olmadan natal Güneş'te yarım derecelik bir belirsizlik olur ve bu da dönüş anını yaklaşık on iki saat kaydırır.
{
"year": 2027,
"exactMomentUtc": "2027-09-06T08:29:55Z",
"location": {
"latitude": 50.4501,
"longitude": 30.5234
},
"chart": "the full chart of that moment, in the shape of /v1/chart/full"
}Bir etkinlik için en iyi günler
POST /v1/timing uç noktası birth, bir activity (general, business, romance, health, creative, travel, home ya da clarity), from ve to (en fazla 62 gün) ve günlerin başlangıcını belirleyen isteğe bağlı bir timezone alır. Her gün, etkinlik için önemli olan gezegenlere göre ağırlıklandırılmış tam transit geometrisinden 0 ile 100 arasında puanlanır ve en iyi beş gün önce gelir. Gökyüzünü betimler; hiçbir gün için vaatte bulunmaz.
{
"activity": "business",
"best": [
{
"date": "2026-10-12",
"score": 69.5,
"rating": "good",
"moonPhase": "New Moon",
"moonSign": "Scorpio",
"voidOfCourse": false,
"favorableAspects": [
"Transit Sun Sextile Moon (0.2°)",
"Transit Mercury Sextile Sun (0.3°)",
"Transit Mercury Sextile Neptune (0.2°)"
],
"challengingAspects": [
"Transit Saturn Square Uranus (0.8°)"
]
},
{
"date": "2026-10-14",
"score": 63.5,
"rating": "good",
"moonPhase": "Waxing Crescent",
"moonSign": "Sagittarius",
"voidOfCourse": false,
"favorableAspects": [
"Transit Sun Sextile Venus (1.1°)",
"Transit Moon Sextile Saturn (0.7°)",
"Transit Jupiter Conjunction Venus (0.1°)"
],
"challengingAspects": [
"Transit Saturn Square Uranus (0.7°)",
"Transit Saturn Square Uranus (0.6°)"
]
}
]
}Bir haritaya göre tek bir yer
POST /v1/locations/score uç noktası birth ve koordinatları içeren bir location alır. Harita o yere taşınır; yanıt, taşınmış haritanın köşe noktalarını, bunların üzerindeki gezegenleri orblarıyla, her yaşam alanı için 0 ile 10 arasında bir puanı (5 nötrdür) ve haritanın o yere genel olarak ne kadar güçlü tepki verdiğini gösterir: bir ana gezegen bir köşe noktasına 2° içinde yakınsa güçlü, 4° içindeyse orta, aksi hâlde zayıf.
{
"relocated": {
"ascendant": {
"longitude": 277.7847,
"sign": "Capricorn"
},
"midheaven": {
"longitude": 210.708,
"sign": "Scorpio"
}
},
"angularPlanets": [
{
"planet": "Uranus",
"angle": "ASC",
"orb": 2.12,
"weight": "major",
"strength": "strong"
},
{
"planet": "Neptune",
"angle": "ASC",
"orb": 6.31,
"weight": "major",
"strength": "weak"
}
],
"spheres": {
"identity": {
"score10": 1,
"verdict": "challenging"
},
"love": {
"score10": 6.1,
"verdict": "slightly supportive"
},
"body": {
"score10": 3.2,
"verdict": "challenging"
},
"money": {
"score10": 2.2,
"verdict": "challenging"
},
"home": {
"score10": 1.7,
"verdict": "challenging"
},
"mind": {
"score10": 4.9,
"verdict": "neutral"
}
},
"overall10": 2.2,
"strength": "moderate"
}Bir harita için en iyi şehirler
POST /v1/locations/rank uç noktası birth, isteğe bağlı bir focus (identity, love, body, money, home, mind değerlerinden dilediğiniz), isteğe bağlı bir region ve 3 ile 12 arasında bir limit alır ve 61 büyük şehirden oluşan bir kataloğu sıralar. Dünyadaki her şehir karşılaştırılmaz; başka herhangi bir yer, yukarıdaki uç noktayla puanlanabilir.
{
"comparedCities": 61,
"top": [
{
"city": "New York",
"country": "United States",
"overall10": 7.4,
"focus10": 8.3,
"strength": "strong",
"contacts": [
"Venus MC 0.6°",
"Moon MC 2.3°"
]
},
{
"city": "Tbilisi",
"country": "Georgia",
"overall10": 7.4,
"focus10": 8.2,
"strength": "moderate",
"contacts": [
"Sun DSC 3.3°"
]
},
{
"city": "Montreal",
"country": "Canada",
"overall10": 7.4,
"focus10": 8.1,
"strength": "strong",
"contacts": [
"Venus MC 0.1°",
"Moon MC 2.8°",
"Mercury MC 3.8°"
]
}
]
}Limitler ve fiyatlar
| Plan | Fiyat | İstekler | Uç noktalar |
|---|---|---|---|
| Ücretsiz | $0 | Günde 10 | Haritalar, bölümler, günlük burç yorumu, gökyüzü |
| Premium | Aylık $9.99 ya da yıllık $79 | Günde 100 | Her şey: transitler, sinastri, Güneş dönüşleri, en iyi günler, konumlar |
| MAX | Aylık $19.99 ya da yıllık $179 | Günlük sınır yok | Her şey: transitler, sinastri, Güneş dönüşleri, en iyi günler, konumlar |
İstekler hesap başına, hesabın tüm anahtarları birlikte sayılır ve havuz 00:00 UTC'de yenilenir. Her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını taşır. Geçersiz olduğu için reddedilen bir istek sayılmaz, bizim tarafımızda başarısız olan bir hesaplama havuza geri eklenir ve GET /v1/usage her zaman ücretsizdir. Premium ve MAX doğrudan uygulamanın planlarıdır: tek abonelik uygulamayı, API'yi ve MCP sunucusunu kapsar ve diğer uygulama planları gibi Aboneliği yönet bağlantısından iptal edilir. Havuzlar yine de ayrıdır: uygulama yapay zekâ yanıtlarını haftalık, bu API ise hesaplamaları UTC gününe göre sayar ve biri diğerinden harcamaz.
Hatalar
Her hata aynı yapıdadır: { "error": { "code", "message", "details"?, "docs", "upgrade_url"? } }.
| Durum | Kod | Ne zaman |
|---|---|---|
| 400 | invalid_request | Gövde geçerli değil. details alanı tüm sorunları listeler. Sayılmaz. |
| 401 | missing_api_key, invalid_api_key | Anahtar yok, anahtar bilinmiyor ya da iptal edilmiş. |
| 403 | plan_required | Ücretsiz planda Premium ve MAX'a özel bir uç nokta çağrıldı. |
| 429 | daily_limit_reached | Günün havuzu tükendi. 00:00 UTC'de yenilenir. |
| 500 | internal_error | Bizim tarafımızda bir hata. İstek sayılmaz. |
Hesaplama ayarları
Bu ayarlar sabittir ve uygulamanın kendi ayarlarıdır; tamamı Haritanızı doğrulayın sayfasında açıklanır ve doğruluk raporunda yayımlanmış tek bir test haritası üzerinde NASA'nın JPL Horizons verileriyle karşılaştırılır. Swiss Ephemeris veri dosyaları, hız bayrağı açık. Tropikal zodyak, yer merkezli, görünür konumlar. Placidus ev sistemi. Gerçek Ay düğümü. Lilith, oskülatör Ay apojesi olarak. Şans Noktası, gündüz ve gece haritalarında aynı biçimde ASC + Ay − Güneş olarak. Yalnızca beş majör açı: kavuşum 8°, altmışlık 6°, kare 8°, üçgen 8°, karşıt 8°. Her natal ve transit açı, iki gök cisminin hızlarına göre (retro hareket de dahil) yaklaşan mı ayrılan mı olduğunu belirtir.
Canlı ortamda
Son 30 günde (19 Eylül 2026 ile 16 Ekim 2026 arasında) sunucu bir hesaplamayı medyan olarak 280 ms, 95. yüzdelikte 526 ms içinde yanıtladı; süre, isteğin ulaşmasından yanıtın çıkmasına kadar ölçüldü. Doğruluk raporu ise yayımlanmış tek bir test haritasının sayılarını NASA JPL Horizons ile karşılaştırır.
Gizlilik
Doğum verileri kişisel veridir. API bunları okur, hesaplar, yanıtlar ve unutur: hiçbir istek gövdesi saklanmaz ve gönderdiğiniz hiçbir şey yanıt dışında bir amaçla kullanılmaz. Her istek için sakladıklarımız uç nokta, durum kodu ve yanıt süresidir. Gizlilik politikasına bakın.
Değişiklik günlüğü
- 2 Kasım 2026: API ve MCP sunucusu artık NatalChart.AI uygulama planlarına dahil: Premium'da günde 100 istekle, MAX'ta günlük sınır olmadan tüm uç noktalar. Anahtarlar uygulamaya, ayarlardaki API & MCP sekmesine taşındı.
- 16 Ekim 2026: 429 ve 403 yanıtları fiyatı belirtiyor ve plan yükseltme bağlantısını içeren bir
upgrade_urlalanı taşıyor. - 3 Ekim 2026: Konum puanları NatalChart.AI uygulamasıyla aynı modeli kullanıyor;
/v1/locations/scoreyanıtınaoverall10alanı eklendi. - 2 Ekim 2026: MCP sunucusu https://www.natalchart.ai/mcp adresinde açıldı ve resmî MCP Registry'de listeleniyor.
- 22 Eylül 2026: Anahtarlar yalın, tırnak içinde ya da Bearer iki kez yazılmış olarak kabul ediliyor ve her 401 yanıtı neyin yanlış gittiğini belirtiyor.
- 19 Eylül 2026: En iyi günler ve iki konum uç noktası API'ye eklendi: toplamda on yedi uç nokta.
- 18 Eylül 2026: API açıldı: ücretsiz anahtarla doğum haritaları, günlük burç yorumu ve gökyüzü; ücretli bir planla transitler, sinastri ve Güneş dönüşleri.
Sorular
API yapay zekâ kullanıyor mu?
Hayır. Her uç nokta bir hesaplamadır: Swiss Ephemeris ile hesaplanan gezegen konumları, ev başlangıçları, açılar, transitler. Metin üretilmez ve hiçbir dil modeli çağrılmaz; aynı girdinin her zaman aynı sayıları döndürmesinin nedeni de budur.
Ev sistemini ya da sideral zodyağı seçebilir miyim?
Hayır. Her harita tropikal zodyakta ve Placidus ev sistemiyle hesaplanır; bunlar NatalChart.AI uygulamasının kullandığı ayarların aynısıdır. Tam Burç ev sistemine (Whole Sign), Koch ev sistemine ya da sideral zodyağa ihtiyacınız varsa bunun için doğru API bu değildir.
Doğum saati bilinmiyorsa ne olur?
time alanını null olarak gönderin. Konumlar varsayılan bir an olarak yerel saatle 12:00 için hesaplanır ve yanıt bunu assumedLocalTime alanında belirtir; kesin saate ihtiyaç duyan her şey ise tahmin edilmek yerine dışarıda bırakılır: köşe noktaları (Yükselen, Tepe Noktası, Vertex, Şans Noktası) ve ev başlangıçları null olarak döner, gök cisimlerine ev atanmaz. Bir uyarı, Ay'ın yaklaşık 7,5 dereceye kadar sapabileceğini ve komşu burçta olabileceğini belirtir; bir burç ya da orb sınırına yakın bir gök cismi ya da açı da gerçek doğum saatinde farklı olabilir.
Yer adlarından koordinat buluyor musunuz?
Hayır. Enlem ve boylam gönderin. Saat dilimi, siz kendiniz bir IANA saat dilimi iletmediğiniz sürece koordinatlardan, o tarihteki tarihsel yaz saati kurallarıyla belirlenir.
Gönderdiğim doğum verilerini saklıyor musunuz?
Hayır. İstek gövdeleri hiçbir yere yazılmaz. İstek kaydında uç nokta, durum kodu ve yanıt süresi tutulur; kullanım sayacının ihtiyaç duyduğu da budur.
Ne istek olarak sayılır?
Bir hesaplama uç noktasına yapılan tek bir başarılı çağrı. Geçersiz olduğu için reddedilen bir istek hiçbir şeye mal olmaz, bizim tarafımızdaki bir hata havuza geri eklenir ve /v1/usage ücretsizdir. Havuz anahtar başına değil, hesap başınadır ve 00:00 UTC'de yenilenir: Ücretsiz planda günde 10, Premium'da günde 100, MAX'ta ise günlük sınır yok.
Ticari bir üründe kullanabilir miyim?
Evet, tüm planlarda. Anahtarınızı bir sunucuda tutun: tarayıcı ya da uygulama kodundaki bir anahtarı, o kodu açan herkes kopyalayabilir.