API s horoskopskimi in astrološkimi podatki za partnerje
JSON API samo za branje nad istimi efemeridami observatorijske natančnosti, na katerih teče Sigastra: dnevni, tedenski in mesečni horoskop za vseh dvanajst znamenj v petnajstih jezikih, poleg tega trenutna lunina mena, današnji planetarni aspekti in ujemanje znamenj. Brez računa in brez fakture (klic s strežnika pove, katera je stran: z naslovom ali brezplačnim ključem): edini pogoj je navedba vira in canonical oznaka, kadar objavljaš celotno besedilo.
Preizkusi
GET /api/v1/daily?lang=en&sign=leoTeče nad živim API-jem neposredno iz tvojega brskalnika. CORS je odprt, zato je to hkrati delujoč primer integracije na strani odjemalca.
Končne točke
GET /api/v1/daily | lang, sign, full | Današnji horoskop. Vseh dvanajst znamenj ali eno. |
GET /api/v1/weekly | lang, sign, full | Tekoči teden, s ključem obdobja in oznako razpona. |
GET /api/v1/monthly | lang, sign, full | Tekoči mesec. |
GET /api/v1/moon | lang | Osvetljeni delež, mena, naraščajoča/pojemajoča, znamenje Lune. Čista efemerida. |
GET /api/v1/cosmic | lang | Najtesnejši aspekti med planeti tistega dne, z orbisi. Čista efemerida. |
GET /api/v1/compat | lang, a, b | Deterministično ujemanje znamenj: rezultat, razred, razmerje elementa in kakovosti. |
Parametri
- lang
- Eden od petnajstih podprtih jezikov (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Vse drugo pade na angleščino, namesto da vrne napako.
- sign
- Angleški ključ (leo), angleški slug (leo) ali slug samega jezika (lev). Izpusti ga za vseh dvanajst.
- full
- full=1 vrne celotno besedilo namesto napovednika. To je način za sindikacijo in vklopi obveznost canonical oznake.
- a, b
- Samo za compat. Dve znamenji, v katerikoli sprejeti obliki.
Napovednik ali celotno besedilo
Privzeto vsak element nosi napovednik: dovolj za kartico, stransko vrstico ali vrstico v viru. Dodaj full=1 in dobiš celotno telo besedila ter objekt sections, ki ustreza izvorni strani. Celotno besedilo je namenjeno ponovni objavi, zato objekt attribution preklopi canonicalRequired na true in ti da natančno oznako za prilepiti.
Omejitev hitrosti
10 zahtevkov na sekundo na IP naslov na robu omrežja, sunek do 30, in dnevna zgornja meja 1.500 zahtevkov na naslov. Založnik, ki štirikrat na dan potegne dvanajst znamenj čez dnevni, tedenski in mesečni horoskop, porabi okoli 150: nobene od obeh meja ne boste dosegli. Nad mejo sledi HTTP 429 s povezavo na to stran. Potrebujete več? Pišite na info@sigastra.com in povejte, kje vsebina teče.
Primeri
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=sl&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=sl&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=sl&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.canonicalTagKanali na Telegramu, korak za korakom
- Odpri sigastra.com/api/partners/verify?site=t.me/tvojkanal. Kanal mora biti javen; brezplačen ključ dobiš takoj, tridnevni preizkus pa se začne s prvim klicem.
- Tvoj bot pokliče API s ključem, na primer /api/v1/daily?lang=sl&sign=leo&key=TVOJ_KLJUC, in objavi besedilo (skrajšano ali prevedeno je v redu, glej pogoje).
- Vsaj ena od tvojih zadnjih desetih objav ima povezavo na sigastra.com z besedo »Sigastra«, brez vrzeli, daljše od sedmih dni. Javni predogled kanala preverjamo samodejno.
API: pogosta vprašanja
Je horoskopski API res brezplačen?+
So, na katerikoli strani, komercialni ali ne. Od prvega klica imaš tri dni preizkusa. Nato se tvoja stran samodejno preverja vsakih nekaj ur: brez povezave se vsebina ustavi in se vrne takoj, ko je povezava znova izmerjena. Če želiš preverjanje takoj, odpri sigastra.com/api/partners/verify?site=tvojadomena.si.
Ali potrebujem API ključ?+
Klici iz brskalnika (pripomočki ali stran, ki sama kliče API) sami pošljejo naslov strani in ne potrebujejo ničesar več. Klici s tvojega strežnika morajo povedati, za katero stran je vsebina: pošlji naslov te strani v glavi Referer (naš vtičnik za WordPress to naredi namesto tebe). Ko tvoja stran prestane preverjanje povezave, na naslovu za preverjanje dobiš tudi brezplačen ključ. Od 15. oktobra 2026 je klic s strežnika, ki ne pošlje ne enega ne drugega, zavrnjen.
Kolikšna je omejitev hitrosti?+
10 zahtevkov na sekundo na IP naslov na robu omrežja, sunek do 30, in dnevna meja 1.500 zahtevkov na naslov. Založnik porabi okoli 150 na dan, torej ne doseže nobene. Nad mejo: HTTP 429: za več pišite na info@sigastra.com.
Ali smem ponovno objaviti celoten horoskop?+
Smeš, z full=1, in takrat moraš dodati canonical oznako, ki ti jo da payload. Brez nje se dve enaki strani potegujeta in iskalnik izbere eno; canonical je tisto, kar ta izbor neha biti met kovanca.
Katere jezike pokriva astrološki API?+
Petnajst: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Imena znamenj, planetov, aspektov in men so lokalizirana.
So podatki izračunani ali napisani?+
Oboje. Položaji planetov, Lunina mena in aspekti se izračunajo iz efemerid. Besedilo horoskopa enkrat na dan napiše umetna inteligenca (Claude podjetja Anthropic) iz izračunanih položajev tistega dne in se shrani: API na tvojo zahtevo nikoli ničesar ne piše, samo prebere, kar že obstaja.
Ali lahko to uporabim v mobilni aplikaciji?+
Ne v izvorni aplikaciji. Program je brezplačen, ker vsebina stoji na javni strani ali kanalu s povezavo, aplikacija pa nima ne enega ne drugega. Spletno mesto ali javni kanal na Telegramu sta v redu; za vse drugo piši na info@sigastra.com.
Vse tukaj je brezplačno. Edini pogoj je vidna povezava: ob objavi celotnega besedila še canonical.
Kako deluje „brezplačno”
- 3 dni za preizkus: v tem času povezava še ni potrebna.
- Od 4. dne: vidna povezava na sigastra.com, katere besedilo vsebuje besedo „Sigastra”, na strani, ki prikazuje vsebino, berljiva vsakomur brez prijave. Vaš jezik je povsem v redu: „Powered by Sigastra”, „Horoskop prinaša Sigastra” ali preprosto „Sigastra”. Ne znotraj okvirja gradnika in ne skrita. Ali dodate rel="nofollow", je vaša izbira.
- Brez nje se vsebina ustavi na vseh površinah (gradnik, slike, JSON), odgovor pa pove natančno, kaj dodati. Vašo stran merimo samodejno.
Povezava dodana? Odprite /api/partners/verify?site=vasa-domena.si in vsebina se vrne v nekaj minutah. Brezplačen partnerski ključ se vaši strani izda samodejno, takoj ko je povezava izmerjena.