API data horoskop dan astrologi untuk mitra
API JSON hanya-baca di atas efemeris presisi tinggi yang sama yang menjalankan Sigastra: horoskop harian, mingguan, dan bulanan untuk seluruh dua belas zodiak dalam lima belas bahasa, ditambah fase Bulan terkini, aspek planet hari ini, dan kecocokan zodiak. Tanpa akun, tanpa kunci, tanpa tagihan — satu-satunya syarat adalah atribusi, dan tag canonical saat kamu menerbitkan teks penuh.
Coba
GET /api/v1/daily?lang=en&sign=leoBerjalan pada API langsung dari peramban kamu. CORS terbuka, jadi ini sekaligus contoh integrasi sisi klien yang berfungsi.
Endpoint
GET /api/v1/daily | lang, sign, full | Horoskop hari ini. Seluruh dua belas zodiak, atau satu saja. |
GET /api/v1/weekly | lang, sign, full | Minggu berjalan, dengan kunci periode dan label rentangnya. |
GET /api/v1/monthly | lang, sign, full | Bulan berjalan. |
GET /api/v1/moon | lang | Bagian yang tersinari, fase, membesar/menyusut, zodiak Bulan. Efemeris murni. |
GET /api/v1/cosmic | lang | Aspek planet-ke-planet paling rapat hari itu, lengkap dengan orbnya. Efemeris murni. |
GET /api/v1/compat | lang, a, b | Kecocokan zodiak deterministik: skor, rentang, hubungan elemen dan modalitas. |
Parameter
- lang
- Salah satu dari lima belas bahasa yang dilayani (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Selain itu jatuh ke bahasa Inggris alih-alih memberi galat.
- sign
- Kunci Inggris (leo), slug Inggris (leo), atau slug bahasa itu sendiri (leo). Kosongkan untuk seluruh dua belas.
- full
- full=1 mengembalikan teks lengkap alih-alih cuplikan. Ini mode sindikasi dan menyalakan kewajiban canonical.
- a, b
- Khusus compat. Dua zodiak, dalam bentuk apa pun yang diterima.
Cuplikan atau teks penuh
Secara bawaan setiap item membawa cuplikan — cukup untuk sebuah kartu, bilah samping, atau baris umpan. Tambahkan full=1 dan kamu mendapat isi lengkap, plus objek sections yang sesuai dengan halaman sumber. Teks penuh ditujukan untuk diterbitkan ulang, jadi objek attribution mengubah canonicalRequired menjadi true dan memberimu tag persisnya untuk ditempel.
Batas laju
10 permintaan per detik per IP, dengan lonjakan 30, ditegakkan di tepi jaringan. Mitra sindikasi menarik sekali sehari per bahasa dan tidak akan pernah melihatnya. Tidak ada batas harian dan tidak ada kuota yang perlu diajukan.
Contoh
curl -s "https://sigastra.com/api/v1/daily?lang=id&sign=leo" | jq .
curl -s "https://sigastra.com/api/v1/weekly?lang=id&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=id&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.canonicalTagSyaratnya, selengkapnya
- Gratis untuk situs mana pun, komersial atau bukan. Tanpa akun, tanpa kunci, tanpa daftar harga.
- Tampilkan tautan “Powered by Sigastra” yang terlihat, do-follow, menuju localizedHref yang kami kembalikan.
- Jika kamu menerbitkan teks PENUH, tambahkan canonicalTag dari payload ke <head> halaman itu.
- Jangan menyajikan konten seolah kamu yang menghitungnya — konten ini dihitung, dan atribusi adalah yang membuat klaim itu bisa diperiksa.
Tanya jawab API
Apakah API horoskop benar-benar gratis?+
Ya — tanpa akun, tanpa kunci, tanpa tagihan, termasuk untuk situs komersial. Syaratnya adalah atribusi dan, untuk teks penuh, tag canonical.
Apakah saya butuh kunci API?+
Tidak. Endpoint bekerja tanpa kunci dan dibatasi lajunya di tepi jaringan. Bentuk responsnya sudah membawa segala hal yang nantinya akan dikaitkan pada sebuah kunci, jadi menambahkannya tidak akan merusak integrasimu.
Berapa batas lajunya?+
10 permintaan per detik per IP dengan lonjakan 30. Tidak ada batas harian.
Bolehkah saya menerbitkan ulang seluruh horoskop?+
Boleh, dengan full=1 — dan saat itu kamu harus menambahkan tag canonical yang diberikan payload. Tanpa itu, dua halaman identik bersaing dan mesin pencari memilih salah satu; canonical yang membuat pilihan itu berhenti menjadi lemparan koin.
Bahasa apa saja yang dicakup API astrologi?+
Lima belas: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nama zodiak, planet, aspek, dan fase semuanya dilokalkan.
Datanya dihitung atau ditulis?+
Dihitung. Fase Bulan dan aspek datang langsung dari efemeris; teks horoskop dibuat setiap hari dari posisi planet nyata hari itu lalu disimpan di cache — API tidak pernah membuat apa pun atas permintaanmu, ia membaca yang sudah ada.
Semua di sini gratis. Satu-satunya syarat adalah tautan do-follow yang terlihat — plus tag canonical bila kamu menerbitkan teks penuh.