{"openapi":"3.0.3","info":{"title":"MineAPI — Astronomy & Astrology Data API","version":"0.1.0","description":"Ay fazları, tutulmalar, gezegen konumları, doğum haritası, ay konakları, Sabian, VOC, gök olayları ve günün enerjisi — tek API. Swiss Ephemeris üzerine kurulu. Tüm yanıtlar { ok, data } zarfında; hata { ok:false, error:{code,message} }.","contact":{"url":"https://minecodecraft.com/mineapi","name":"Mine Code Craft"}},"servers":[{"description":"Production","url":"https://minecodecraft.com/mineapi/api"}],"tags":[{"description":"Astronomi + astroloji hesaplama uçları","name":"MineAPI"}],"paths":{"/moon/now":{"get":{"summary":"Anlık ay durumu (faz, aydınlanma, mesafe, açısal çap, burç, doğuş/batış)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/moon/cycle":{"get":{"summary":"Mevcut ay döngüsünün 8 fazı (geocentric; konum opsiyonel)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":false,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/moon/phases":{"get":{"summary":"Yıllık yeni ay / dolunay (super/micro/blue/black/blood + tutulma; geocentric, konum opsiyonel)","tags":["MineAPI"],"parameters":[{"name":"year","in":"query","required":false,"description":"Yıl (verilmezse date'ten türetilir)","schema":{"type":"integer"}},{"name":"lat","in":"query","required":false,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":false,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"tz","in":"query","required":false,"description":"IANA saat dilimi (ör. Europe/Istanbul; vars. UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/sun/riseset":{"get":{"summary":"Güneş doğuş/batış + sivil/denizci/astronomik alacakaranlık","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"tz","in":"query","required":false,"description":"IANA saat dilimi (ör. Europe/Istanbul; vars. UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/eclipses":{"get":{"summary":"İleriye dönük güneş + ay tutulmaları (tip, zaman, konak)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"sidereal","in":"query","required":false,"description":"Sidereal (Lahiri) mi? true/false (vars. false=tropikal)","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/eclipses/local":{"get":{"summary":"Bir konum için sonraki tutulmanın yerel koşulları (görünürlük, temas zamanları, büyüklük)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"sidereal","in":"query","required":false,"description":"Sidereal (Lahiri) mi? true/false (vars. false=tropikal)","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/sky-events":{"get":{"summary":"Yıllık gök olayları (ekinoks/gündönümü, meteor, özel ay fazları, astrolojik yeni yıl)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Yıl (verilmezse date'ten türetilir)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/planets":{"get":{"summary":"Gezegen konumları (burç/ev/retrograde) + ev cuspları","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"houseSystem","in":"query","required":false,"description":"Ev sistemi indeksi (0=Placidus, 1=Koch, 7=Whole Sign...; vars. 0)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/natal-chart":{"get":{"summary":"Doğum haritası: gezegenler + evler + aspektler + ay konağı","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":true,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"houseSystem","in":"query","required":false,"description":"Ev sistemi indeksi (0=Placidus, 1=Koch, 7=Whole Sign...; vars. 0)","schema":{"type":"string"}},{"name":"sidereal","in":"query","required":false,"description":"Sidereal (Lahiri) mi? true/false (vars. false=tropikal)","schema":{"type":"boolean"}},{"name":"lang","in":"query","required":false,"description":"Dil/locale (ör. tr, en, pt_br; vars. en)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/aspects":{"get":{"summary":"Ay-gezegen majör açıları (önümüzdeki pencere)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Pencere uzunluğu (gün, 1-60; vars. 7)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/planetary-hours":{"get":{"summary":"Klasik (Kaldean) gezegen saatleri (24; tz zorunlu — yönetici gezegen yerel hafta gününe bağlı)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"tz","in":"query","required":true,"description":"IANA saat dilimi (ör. Europe/Istanbul; vars. UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/lunar-mansion":{"get":{"summary":"Ay konağı (1-28, Picatrix/İbn Arabi, tropikal/sidereal)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"sidereal","in":"query","required":false,"description":"Sidereal (Lahiri) mi? true/false (vars. false=tropikal)","schema":{"type":"boolean"}},{"name":"lang","in":"query","required":false,"description":"Dil/locale (ör. tr, en, pt_br; vars. en)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/sabian":{"get":{"summary":"Bir ekliptik dereceye karşılık Sabian sembolü","tags":["MineAPI"],"parameters":[{"name":"lon","in":"query","required":false,"description":"Ekliptik boylam (derece, 0-360)","schema":{"type":"number"}},{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Dil/locale (ör. tr, en, pt_br; vars. en)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/voc":{"get":{"summary":"Boşlukta seyir (VOC) dönemleri (içinde bulunulan ay)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"tz","in":"query","required":false,"description":"IANA saat dilimi (ör. Europe/Istanbul; vars. UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/uranian-planets":{"get":{"summary":"Hamburg/Uranian okul gezegenleri (Cupido…Poseidon) ekliptik boylamları","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/season":{"get":{"summary":"Yarımküre + mevsim bayrakları (Güneş ekliptik boylamına göre)","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/astro/fixed-star-syrma":{"get":{"summary":"Syrma (ι Vir) sabit yıldızına Ay/Güneş/Mars kavuşum penceresi","tags":["MineAPI"],"parameters":[{"name":"date","in":"query","required":false,"description":"Tarih: epoch-ms veya yyyy-MM-dd (verilmezse şimdi)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}},"/calendar/monthly":{"get":{"summary":"Aylık gök takvimi: her gün Ay burcu, burç geçiş anı, ana faz","tags":["MineAPI"],"parameters":[{"name":"year","in":"query","required":false,"description":"Yıl (verilmezse date'ten türetilir)","schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"description":"Ay (1-12; verilmezse date'ten türetilir)","schema":{"type":"integer"}},{"name":"lat","in":"query","required":true,"description":"Enlem (derece, +Kuzey)","schema":{"type":"number"}},{"name":"lng","in":"query","required":true,"description":"Boylam (derece, +Doğu)","schema":{"type":"number"}},{"name":"tz","in":"query","required":false,"description":"IANA saat dilimi (ör. Europe/Istanbul; vars. UTC)","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Dil/locale (ör. tr, en, pt_br; vars. en)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı — { ok:true, data:... } zarfı"},"400":{"description":"Geçersiz parametre"},"500":{"description":"Hesaplama/iç hata"}}}}}}