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, brez ključa, brez fakture — edini pogoj je navedba vira in canonical oznaka, kadar objavljaš celotno besedilo.

Preizkusi

full=1

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

Teč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, s sunkom do 30, uveljavljeno na robu omrežja. Partner, ki sindicira, potegne enkrat dnevno na jezik in je nikoli ne bo videl. Dnevne omejitve ni in ni kvote, za katero bi se prijavljal.

Primeri

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

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

Pogoji, v celoti

Brezplačno za vsako spletno mesto, komercialno ali ne. Brez računa, brez ključa, brez cenika.
Prikaži viden „Powered by Sigastra” link, do-follow, ki vodi na localizedHref, ki ga vrnemo.
Če objavljaš CELOTNO besedilo, dodaj canonicalTag iz payloada v <head> te strani.
Vsebine ne predstavljaj, kot da si jo izračunal ti — izračunana je, navedba vira pa je tisto, kar to trditev naredi preverljivo.

API — pogosta vprašanja

Je horoskopski API res brezplačen?+

Je — brez računa, brez ključa, brez fakture, tudi za komercialna spletna mesta. Pogoja sta navedba vira in, za celotno besedilo, canonical oznaka.

Ali potrebujem API ključ?+

Ne. Končne točke delujejo brez ključa, omejene pa so po hitrosti na robu omrežja. Oblika odgovora že nosi vse, na kar bi se ključ pozneje pripel, zato njegova uvedba tvoje integracije ne bi pokvarila.

Kolikšna je omejitev hitrosti?+

10 zahtevkov na sekundo na IP naslov, s sunkom do 30. Dnevne omejitve ni.

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

Izračunani. Lunina mena in aspekti prihajajo naravnost iz efemeride; besedilo horoskopa se vsak dan ustvari iz dejanskih položajev planetov tistega dne in shrani v predpomnilnik — API nikoli ne ustvarja na tvoj zahtevek, ampak bere tisto, kar že obstaja.

Vse tukaj je brezplačno. Edini pogoj je vidna do-follow povezava — ob objavi celotnega besedila še canonical.

Pripomočki →Sindikacija →WordPress →Pregled →