API s horoskopskim i astrološkim podacima za partnere
JSON API samo za čitanje nad istim efemeridama opservatorijske preciznosti na kojima radi Sigastra: dnevni, tjedni i mjesečni horoskop za svih dvanaest znakova na petnaest jezika, plus trenutna mjesečeva mijena, današnji planetarni aspekti i sparivanje znakova. Bez računa i bez fakture (poziv s poslužitelja kaže koja je stranica: adresom ili besplatnim ključem): jedini uvjet je atribucija, i canonical oznaka kada objavljuješ cijeli tekst.
Isprobaj
GET /api/v1/daily?lang=en&sign=leoRadi nad živim API-jem izravno iz tvog preglednika. CORS je otvoren, pa je ovo ujedno i radni primjer integracije na strani klijenta.
Endpointi
GET /api/v1/daily | lang, sign, full | Današnji horoskop. Svih dvanaest znakova, ili jedan. |
GET /api/v1/weekly | lang, sign, full | Tekući tjedan, s ključem razdoblja i oznakom raspona. |
GET /api/v1/monthly | lang, sign, full | Tekući mjesec. |
GET /api/v1/moon | lang | Osvijetljeni dio, mijena, rastuća/opadajuća, znak Mjeseca. Čista efemerida. |
GET /api/v1/cosmic | lang | Najbliži aspekti između planeta za taj dan, s orbisima. Čista efemerida. |
GET /api/v1/compat | lang, a, b | Determinističko sparivanje znakova: rezultat, raspon, odnos elementa i kvalitete. |
Parametri
- lang
- Jedan od petnaest podržanih jezika (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Sve ostalo pada na engleski umjesto da vrati grešku.
- sign
- Engleski ključ (leo), engleski slug (leo) ili slug samog lokala (lav). Izostavi ga za svih dvanaest.
- full
- full=1 vraća kompletan tekst umjesto najave. To je način rada za sindikaciju i on uključuje obvezu canonical oznake.
- a, b
- Samo za compat. Dva znaka, u bilo kojem od prihvaćenih oblika.
Najava ili cijeli tekst
Prema zadanim postavkama svaka stavka nosi najavu: dovoljno za karticu, bočnu traku ili redak u feedu. Dodaj full=1 i dobivaš cijelo tijelo teksta, plus objekt sections koji odgovara izvornoj stranici. Cijeli tekst namijenjen je ponovnoj objavi, pa objekt attribution prebacuje canonicalRequired na true i daje ti točnu oznaku za zalijepiti.
Ograničenje brzine
10 zahtjeva u sekundi po IP adresi na rubu mreže, nalet do 30, i dnevni plafon od 1.500 zahtjeva po adresi. Izdavač koji povlači dvanaest znakova kroz dnevni, tjedni i mjesečni horoskop, četiri puta dnevno, potroši oko 150: nijedno ograničenje nećete dotaknuti. Preko plafona stiže HTTP 429 s poveznicom na ovu stranicu. Treba vam više? Pišite na info@sigastra.com i recite nam gdje sadržaj ide.
Primjeri
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=hr&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=hr&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=hr&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 kanali, korak po korak
- Otvori sigastra.com/api/partners/verify?site=t.me/tvojkanal. Kanal mora biti javan; odmah dobivaš besplatan ključ, a proba od tri dana počinje prvim pozivom.
- Tvoj bot poziva API s ključem, na primjer /api/v1/daily?lang=hr&sign=leo&key=TVOJ_KLJUC, i objavljuje tekst (skraćen ili preveden je u redu, vidi uvjete).
- Barem jedna od zadnjih deset objava ima poveznicu na sigastra.com s riječju „Sigastra”, bez praznine dulje od sedam dana. Javni pregled kanala provjeravamo automatski.
API: česta pitanja
Je li horoskop API stvarno besplatan?+
Jesu, na bilo kojoj stranici, komercijalnoj ili ne. Od prvog poziva imaš tri dana probe. Nakon toga tvoja se stranica automatski provjerava svakih nekoliko sati: bez poveznice sadržaj staje, a vraća se čim se poveznica ponovno izmjeri. Ako želiš provjeru odmah, otvori sigastra.com/api/partners/verify?site=tvojadomena.hr.
Trebam li API ključ?+
Pozivi iz preglednika (widgeti ili stranica koja sama poziva API) sami šalju adresu stranice i ne treba im ništa više. Pozivi s tvog poslužitelja moraju reći za koju je stranicu sadržaj: pošalji adresu te stranice kao zaglavlje Referer (naš WordPress dodatak to radi umjesto tebe). Kad tvoja stranica prođe provjeru poveznice, na adresi za provjeru dobivaš i besplatan ključ. Od 15. listopada 2026. poziv s poslužitelja koji ne pošalje ni jedno ni drugo bit će odbijen.
Koliko iznosi ograničenje brzine?+
10 zahtjeva u sekundi po IP adresi na rubu mreže, nalet do 30, plus dnevni plafon od 1.500 zahtjeva po adresi. Izdavač potroši oko 150 dnevno, pa nijedno neće dotaknuti. Preko plafona: HTTP 429: za više pišite na info@sigastra.com.
Smijem li ponovno objaviti cijeli horoskop?+
Smiješ, uz full=1, i tada moraš dodati canonical oznaku koju ti payload daje. Bez nje se dvije identične stranice natječu i tražilica bira jednu; canonical je ono što taj izbor prestaje biti bacanje novčića.
Koje jezike astrološki API pokriva?+
Petnaest: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Imena znakova, planeta, aspekata i mijena su lokalizirana.
Jesu li podaci izračunati ili napisani?+
Oboje. Položaji planeta, Mjesečeva mijena i aspekti računaju se iz efemerida. Tekst horoskopa jednom dnevno piše umjetna inteligencija (Claude, tvrtke Anthropic) iz izračunatih položaja tog dana i sprema se: API na tvoj zahtjev ništa ne piše, samo čita ono što već postoji.
Mogu li ovo koristiti u mobilnoj aplikaciji?+
Ne u aplikaciji koja se instalira na mobitel. Program je besplatan zato što sadržaj stoji na javnoj stranici ili kanalu koji nosi poveznicu, a aplikacija nema ni jedno ni drugo. Web-stranica ili javni Telegram kanal su u redu; za sve ostalo piši na info@sigastra.com.
Sve ovdje je besplatno. Jedini uvjet je vidljiv link: uz canonical tag ako objavljuješ puni tekst.
Kako radi „besplatno”
- 3 dana za probu: za to vrijeme poveznica još nije potrebna.
- Od 4. dana: vidljiva poveznica na sigastra.com čiji tekst sadrži riječ „Sigastra”, na stranici koja prikazuje sadržaj, čitljiva svakome bez prijave. Može i na tvom jeziku: „Powered by Sigastra”, „Horoskop donosi Sigastra” ili jednostavno „Sigastra”. Ne unutar okvira widgeta i ne skrivena. Hoćeš li staviti rel="nofollow", tvoj je izbor.
- Bez nje sadržaj staje na svim površinama (widget, slike, JSON), a odgovor kaže točno što treba dodati. Tvoju stranicu mjerimo automatski.
Postavio si poveznicu? Otvori /api/partners/verify?site=tvoja-domena.hr i sadržaj se vraća za nekoliko minuta. Besplatan partnerski ključ tvojoj se stranici izdaje automatski čim poveznica bude izmjerena.