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, bez ključa, bez fakture — jedini uslov je atribucija, i canonical oznaka kada objavljuješ pun tekst.

Probaj

full=1

GET /api/v1/daily?lang=en&sign=leo

Radi 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, sa naletom do 30, sprovedeno na ivici mreže. Partner koji sindikuje povlači jednom dnevno po jeziku i nikada ga neće videti. Nema dnevnog ograničenja niti kvote za koju se konkuriše.

Primeri

curl -s "https://sigastra.com/api/v1/daily?lang=sr&sign=leo" | jq .

curl -s "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.canonicalTag

Uslovi, u celini

Besplatno za svaki sajt, komercijalni ili ne. Bez naloga, bez ključa, bez cenovnika.
Prikaži vidljiv „Powered by Sigastra” link, do-follow, koji vodi na localizedHref koji vraćamo.
Ako objavljuješ PUN tekst, dodaj canonicalTag iz payload-a u <head> te strane.
Ne predstavljaj sadržaj kao da si ga ti izračunao — jeste izračunat, a atribucija je ono što tu tvrdnju čini proverljivom.

API — česta pitanja

Da li je horoskop API stvarno besplatan?+

Jeste — bez naloga, bez ključa, bez fakture, i za komercijalne sajtove. Uslovi su atribucija i, za pun tekst, canonical oznaka.

Treba li mi API ključ?+

Ne. Endpointi rade bez ključa, a ograničeni su po brzini na ivici mreže. Oblik odgovora već nosi sve na šta bi se ključ kasnije zakačio, pa njegovo uvođenje ne bi pokvarilo tvoju integraciju.

Koliko iznosi ograničenje brzine?+

10 zahteva u sekundi po IP adresi, sa naletom do 30. Dnevnog ograničenja nema.

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?+

Izračunati. Mesečeva mena i aspekti dolaze pravo iz efemeride; tekst horoskopa se svakodnevno generiše iz stvarnih položaja planeta tog dana i kešira — API nikada ne generiše na tvoj zahtev, on čita ono što već postoji.

Sve ovde je besplatno. Jedini uslov je vidljiv do-follow link — uz canonical tag ako objavljuješ pun tekst.

Vidžeti →Sindikacija →WordPress →Pregled →