API sa horoskopskim i astrološkim podacima za partnere
JSON API samo za čitanje nad istim efemeridama opservatorijske preciznosti na kojima radi Sigastra: dnevni, nedeljni i mesečni horoskop za svih dvanaest znakova na petnaest jezika, plus trenutna mesečeva mena, današnji planetarni aspekti i uparivanje znakova. Bez naloga i bez fakture (poziv sa servera kaže koji je sajt: adresom ili besplatnim ključem): jedini uslov je atribucija, i canonical oznaka kada objavljuješ pun tekst.
Probaj
GET /api/v1/daily?lang=en&sign=leoRadi nad živim API-jem direktno iz tvog pregledača. CORS je otvoren, pa je ovo istovremeno i radni primer 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ća nedelja, sa ključem perioda i oznakom raspona. |
GET /api/v1/monthly | lang, sign, full | Tekući mesec. |
GET /api/v1/moon | lang | Osvetljeni deo, mena, rastuća/opadajuća, znak Meseca. Čista efemerida. |
GET /api/v1/cosmic | lang | Najbliži aspekti između planeta za taj dan, sa orbisima. Čista efemerida. |
GET /api/v1/compat | lang, a, b | Determinističko uparivanje znakova: skor, opseg, odnos elementa i kvaliteta. |
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 umesto 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 umesto najave. To je režim za sindikaciju i on uključuje obavezu canonical oznake.
- a, b
- Samo za compat. Dva znaka, u bilo kom od prihvaćenih oblika.
Najava ili pun tekst
Podrazumevano svaka stavka nosi najavu: dovoljno za karticu, bočnu traku ili red u feedu. Dodaj full=1 i dobijaš celo telo teksta, plus objekat sections koji odgovara izvornoj strani. Pun tekst je namenjen preobjavljivanju, pa objekat attribution prebacuje canonicalRequired na true i daje ti tačnu oznaku za nalepiti.
Ograničenje brzine
10 zahteva u sekundi po IP adresi na ivici mreže, nalet do 30, i dnevni plafon od 1.500 zahteva po adresi. Izdavač koji povlači dvanaest znakova kroz dnevni, nedeljni i mesečni horoskop, četiri puta dnevno, potroši oko 150: nijedno ograničenje nećete dotaći. Preko plafona stiže HTTP 429 sa linkom na ovu stranicu. Treba vam više? Pišite na info@sigastra.com i recite nam gde sadržaj ide.
Primeri
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=sr&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=sr&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=sr&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 dobijaš besplatan ključ, a proba od tri dana počinje prvim pozivom.
- Tvoj bot zove API sa ključem, na primer /api/v1/daily?lang=sr&sign=leo&key=TVOJ_KLJUC, i objavljuje tekst (skraćen ili preveden je u redu, vidi uslove).
- Bar jedna od poslednjih deset objava ima link na sigastra.com sa rečju „Sigastra”, bez praznine duže od sedam dana. Javni pregled kanala proveravamo automatski.
API: česta pitanja
Da li je horoskop API stvarno besplatan?+
Jesu, na bilo kom sajtu, komercijalnom ili ne. Od prvog poziva imaš tri dana probe. Posle toga se tvoja strana automatski proverava na svakih nekoliko sati: bez linka sadržaj staje, a vraća se čim se link ponovo izmeri. Ako hoćeš proveru odmah, otvori sigastra.com/api/partners/verify?site=tvojdomen.rs.
Treba li mi API ključ?+
Pozivi iz pregledača (vidžeti ili strana koja sama zove API) sami šalju adresu strane i ne treba im ništa više. Pozivi sa tvog servera moraju da kažu za koji sajt je sadržaj: pošalji adresu te strane kao Referer zaglavlje (naš WordPress dodatak to radi umesto tebe). Kad tvoj sajt prođe proveru linka, na adresi za proveru dobijaš i besplatan ključ. Od 15. oktobra 2026. poziv sa servera koji ne pošalje ni jedno ni drugo biva odbijen.
Koliko iznosi ograničenje brzine?+
10 zahteva u sekundi po IP adresi na ivici mreže, nalet do 30, plus dnevni plafon od 1.500 zahteva po adresi. Izdavač potroši oko 150 dnevno, pa nijedno neće dotaći. Preko plafona: HTTP 429: za više pišite na info@sigastra.com.
Smem li da preobjavim ceo horoskop?+
Smeš, uz full=1, i tada moraš da dodaš canonical oznaku koju ti payload daje. Bez nje se dve identične strane takmiče i pretraživač bira jednu; canonical je ono što taj izbor prestaje da bude 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 mena su lokalizovana.
Da li su podaci izračunati ili napisani?+
Oboje. Položaji planeta, Mesečeva mena i aspekti se računaju iz efemerida. Tekst horoskopa jednom dnevno piše veštačka inteligencija (Claude, kompanije Anthropic) iz izračunatih položaja tog dana i čuva se: API na tvoj zahtev ništa ne piše, samo čita ono što već postoji.
Mogu li ovo da koristim u mobilnoj aplikaciji?+
Ne u aplikaciji koja se instalira na telefon. Program je besplatan zato što sadržaj stoji na javnoj strani ili kanalu koji nosi link, a aplikacija nema ni jedno ni drugo. Sajt ili javni Telegram kanal su u redu; za sve ostalo piši na info@sigastra.com.
Sve ovde je besplatno. Jedini uslov je vidljiv link, uz canonical tag ako objavljuješ pun tekst.
Kako radi „besplatno”
- 3 dana za probu: za to vreme link još ne treba.
- Od 4. dana: vidljiv link ka sigastra.com čiji tekst sadrži reč „Sigastra”, na strani koja prikazuje sadržaj, čitljiv svakome bez prijave. Može i na tvom jeziku: „Powered by Sigastra”, „Horoskop donosi Sigastra” ili prosto „Sigastra”. Ne unutar okvira vidžeta i ne sakriven. Da li ćeš staviti rel="nofollow", tvoj je izbor.
- Bez njega sadržaj staje na svim površinama (vidžet, slike, JSON), a odgovor kaže tačno šta treba dodati. Tvoju stranu merimo automatski.
Postavio si link? Otvori /api/partners/verify?site=tvoj-domen.rs i sadržaj se vraća za par minuta. Besplatan partnerski ključ se tvom sajtu izdaje automatski čim link bude izmeren.