Ortaklar için burç ve astroloji verisi API’si
Sigastra’yı çalıştıran yüksek hassasiyetli efemerislerin üzerinde salt okunur bir JSON API: on iki burcun tamamı için on beş dilde günlük, haftalık ve aylık burç yorumları, ayrıca canlı ay evresi, bugünün gezegen açıları ve burç uyumu. Hesap yok, anahtar yok, fatura yok — tek koşul kaynak göstermek ve tam metni yayımladığınızda bir canonical etiketi.
Deneyin
GET /api/v1/daily?lang=en&sign=leoTarayıcınızdan canlı API’ye karşı çalışır. CORS açık olduğundan bu aynı zamanda istemci tarafı entegrasyonunun çalışan bir örneğidir.
Uç noktalar
GET /api/v1/daily | lang, sign, full | Bugünün burç yorumu. On iki burcun tamamı ya da bir tanesi. |
GET /api/v1/weekly | lang, sign, full | İçinde bulunulan hafta, dönem anahtarı ve aralık etiketiyle. |
GET /api/v1/monthly | lang, sign, full | İçinde bulunulan ay. |
GET /api/v1/moon | lang | Aydınlanan oran, evre, büyüyen/küçülen, ay burcu. Saf efemeris. |
GET /api/v1/cosmic | lang | Günün en dar gezegen-gezegen açıları, orblarıyla. Saf efemeris. |
GET /api/v1/compat | lang, a, b | Determinist burç uyumu: puan, aralık, element ve nitelik ilişkisi. |
Parametreler
- lang
- Sunulan on beş dilden biri (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Başka bir değer hata vermek yerine İngilizceye düşer.
- sign
- İngilizce anahtar (leo), İngilizce slug (leo) ya da dilin kendi slug’ı (aslan). On ikisi için boş bırakın.
- full
- full=1 tanıtım yerine tam metni döndürür. Bu dağıtım kipidir ve canonical yükümlülüğünü açar.
- a, b
- Yalnızca compat için. Kabul edilen biçimlerden herhangi biriyle iki burç.
Tanıtım mı, tam metin mi
Varsayılan olarak her öğe bir tanıtım taşır — bir kart, bir kenar çubuğu ya da bir akış satırı için yeterli. full=1 ekleyin, kaynak sayfayla eşleşen bir sections nesnesiyle birlikte tam gövdeyi alın. Tam metin yeniden yayımlamak içindir, bu yüzden attribution nesnesi canonicalRequired değerini true yapar ve yapıştıracağınız tam etiketi size verir.
Hız sınırı
IP başına saniyede 10 istek, 30’luk bir taşmayla, ağın kenarında uygulanır. Dağıtım yapan bir ortak dil başına günde bir kez çeker ve bunu asla görmez. Günlük tavan yok, başvurulacak kota yok.
Örnekler
curl -s "https://sigastra.com/api/v1/daily?lang=tr&sign=leo" | jq .
curl -s "https://sigastra.com/api/v1/weekly?lang=tr&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=tr&sign=leo");
const { items, attribution } = await res.json();
document.querySelector("#horoscope").textContent = items[0].text;
document.querySelector("#credit").outerHTML =
`<a href="${attribution.localizedHref}">${attribution.text}</a>`;
// Publishing the FULL text (full=1)? Also put this in <head>:
// attribution.canonicalTagKoşulların tamamı
- Ticari olsun olmasın her site için ücretsiz. Hesap yok, anahtar yok, fiyat listesi yok.
- Döndürdüğümüz localizedHref adresine giden, görünür “Powered by Sigastra” bağlantısını do-follow olarak gösterin.
- TAM metni yayımlıyorsanız, payload’daki canonicalTag’i o sayfanın <head> bölümüne ekleyin.
- İçeriği sizin hesapladığınız gibi sunmayın — hesaplanmıştır, ve kaynak gösterimi bu iddiayı denetlenebilir kılan şeydir.
API SSS
Burç API’si gerçekten ücretsiz mi?+
Evet — hesap yok, anahtar yok, fatura yok; ticari siteler için de geçerli. Koşullar kaynak gösterimi ve tam metin için canonical etiketi.
API anahtarına ihtiyacım var mı?+
Hayır. Uç noktalar anahtarsız çalışır, bunun yerine ağın kenarında hız sınırına tabidir. Yanıtın biçimi bir anahtarın sonradan bağlanacağı her şeyi zaten taşıyor, dolayısıyla anahtar eklenmesi entegrasyonunuzu bozmaz.
Hız sınırı nedir?+
IP başına saniyede 10 istek, 30’luk taşmayla. Günlük tavan yoktur.
Burç yorumunun tamamını yeniden yayımlayabilir miyim?+
Evet, full=1 ile — ve o zaman payload’ın verdiği canonical etiketini eklemeniz gerekir. Onsuz iki özdeş sayfa yarışır ve arama motoru birini seçer; canonical, bu seçimin yazı tura olmasını engelleyen şeydir.
Astroloji API’si hangi dilleri kapsıyor?+
On beş: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Burç, gezegen, açı ve evre adlarının tamamı yerelleştirilmiştir.
Veriler hesaplanıyor mu, yazılıyor mu?+
Hesaplanıyor. Ay evresi ve açılar doğrudan efemeristen gelir; burç metni her gün o günün gerçek gezegen konumlarından üretilir ve önbelleğe alınır — API sizin isteğinizle asla üretmez, halihazırda orada olanı okur.
Buradaki her şey ücretsizdir. Tek koşul görünür bir do-follow bağlantısı — tam metni yayımlarsanız ayrıca bir canonical etiketi.