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

Isprobaj

full=1

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

Radi 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, s naletom do 30, provedeno na rubu mreže. Partner koji sindicira povlači jednom dnevno po jeziku i nikada ga neće vidjeti. Nema dnevnog ograničenja ni kvote za koju se prijavljuje.

Primjeri

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

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

Uvjeti, u cijelosti

Besplatno za svaku stranicu, komercijalnu ili ne. Bez računa, bez ključa, bez cjenika.
Prikaži vidljiv „Powered by Sigastra” link, do-follow, koji vodi na localizedHref koji vraćamo.
Ako objavljuješ CIJELI tekst, dodaj canonicalTag iz payloada u <head> te stranice.
Nemoj predstavljati sadržaj kao da si ga ti izračunao — jest izračunat, a atribucija je ono što tu tvrdnju čini provjerljivom.

API — česta pitanja

Je li horoskop API stvarno besplatan?+

Jest — bez računa, bez ključa, bez fakture, i za komercijalne stranice. Uvjeti su atribucija i, za cijeli tekst, canonical oznaka.

Trebam li API ključ?+

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

Koliko iznosi ograničenje brzine?+

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

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

Izračunati. Mjesečeva mijena i aspekti dolaze ravno iz efemeride; tekst horoskopa generira se svakodnevno iz stvarnih položaja planeta tog dana i sprema u predmemoriju — API nikada ne generira na tvoj zahtjev, on čita ono što već postoji.

Sve ovdje je besplatno. Jedini uvjet je vidljiv do-follow link — uz canonical tag ako objavljuješ puni tekst.

Widgeti →Sindikacija →WordPress →Pregled →