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, fatura yok (sunucu çağrıları sitenizi belirtir: adresle ya da ücretsiz anahtarla): 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ı
Ağın kenarında IP başına saniyede 10 istek, 30’luk taşma ve adres başına günde 1.500 isteklik bir tavan. On iki burcu günlük, haftalık ve aylık olarak günde dört kez çeken bir yayıncı yaklaşık 150 istek harcar; iki sınıra da değmezsiniz. Tavanın üstünde yanıt, bu sayfaya bağlantı veren bir HTTP 429’dur. Daha fazla hacim mi gerekiyor? info@sigastra.com adresine yazın ve içeriğin nerede yayımlandığını bildirin.
Örnekler
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=tr&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagTelegram kanalları adım adım
- sigastra.com/api/partners/verify?site=t.me/kanaliniz adresini açın. Kanal herkese açık olmalıdır; ücretsiz anahtarı hemen alırsınız ve üç günlük deneme ilk çağrıyla başlar.
- Botunuz API’yi anahtarla çağırır, örneğin /api/v1/daily?lang=tr&sign=leo&key=ANAHTARINIZ, ve metni paylaşır (kısaltılmış ya da çevrilmiş olabilir, koşullara bakın).
- Son on gönderinizden en az biri “Sigastra” kelimesiyle sigastra.com’a bağlantı verir ve yedi günden uzun bir boşluk olmaz. Kanalın herkese açık önizlemesini otomatik olarak kontrol ederiz.
API SSS
Burç API’si gerçekten ücretsiz mi?+
Evet, ticari olsun olmasın her sitede. İlk çağrınızdan itibaren üç günlük deneme süreniz vardır. Ardından sayfanız birkaç saatte bir otomatik olarak kontrol edilir: bağlantı yoksa içerik durur ve bağlantı yeniden ölçüldüğü anda geri gelir. Hemen kontrol ettirmek için sigastra.com/api/partners/verify?site=alanadiniz.com adresini açın.
API anahtarına ihtiyacım var mı?+
Tarayıcıdan yapılan çağrılar (widget’lar ya da API’yi kendisi çağıran bir sayfa) sayfa adresini kendiliğinden gönderir ve başka bir şeye ihtiyaç duymaz. Sunucunuzdan yapılan çağrılar içeriğin hangi site için olduğunu belirtmelidir: o sayfanın adresini Referer başlığı olarak gönderin (WordPress eklentimiz bunu sizin yerinize yapar). Siteniz bağlantı kontrolünü geçtiğinde doğrulama adresi size ücretsiz bir anahtar da verir. 15 Ekim 2026’dan itibaren ikisini de göndermeyen bir sunucu çağrısı reddedilir.
Hız sınırı nedir?+
Ağın kenarında IP başına saniyede 10 istek, 30’luk taşma ve adres başına günde 1.500 isteklik bir tavan. Bir yayıncı günde yaklaşık 150 istek harcar, ikisine de değmez. Tavanın üstünde: HTTP 429: daha fazla hacim için info@sigastra.com adresine yazın.
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?+
İkisi de. Gezegen konumları, Ay evresi ve açılar efemeristen hesaplanır. Burç yorumu metnini günde bir kez, o günün hesaplanan konumlarından yapay zekâ (Anthropic’in Claude modeli) yazar ve ardından önbelleğe alınır: API sizin isteğiniz üzerine hiçbir şey yazmaz, yalnızca zaten var olanı okur.
Bunu bir mobil uygulamada kullanabilir miyim?+
Yerel bir uygulamada hayır. Program ücretsizdir çünkü içerik, bağlantıyı taşıyan herkese açık bir sayfada veya kanalda durur; bir uygulamada ise ikisi de yoktur. Bir web sitesi ya da herkese açık bir Telegram kanalı uygundur; diğer her şey için info@sigastra.com adresine yazın.
Buradaki her şey ücretsizdir. Tek koşul görünür bir bağlantısı: tam metni yayımlarsanız ayrıca bir canonical etiketi.
Ücretsiz nasıl işler
- Denemek için 3 gün: bu sürede henüz bağlantı gerekmez.
- 4. günden itibaren: içeriği gösteren sayfada, giriş yapmadan herkesin görebildiği, metninde "Sigastra" kelimesi geçen, sigastra.com adresine giden görünür bir bağlantı. Kendi diliniz olur: "Powered by Sigastra", "Sigastra ile burç yorumları" ya da sadece "Sigastra". Widget çerçevesinin içinde değil ve gizli değil. rel="nofollow" eklemek sizin tercihinizdir.
- Bağlantı yoksa içerik tüm yüzeylerde durur (widget, görseller, JSON) ve yanıt tam olarak ne eklenmesi gerektiğini söyler. Canlı sayfanızı otomatik ölçüyoruz.
Bağlantıyı eklediniz mi? /api/partners/verify?site=alan-adiniz.com adresini açın; içerik dakikalar içinde geri gelir. Bağlantı ölçülür ölçülmez sitenize ücretsiz bir partner anahtarı otomatik verilir.