API danych horoskopowych i astrologicznych dla partnerów

API JSON tylko do odczytu oparte na tych samych precyzyjnych efemerydach, na których działa Sigastra: horoskopy dzienne, tygodniowe i miesięczne dla wszystkich dwunastu znaków w piętnastu językach, a do tego bieżąca faza Księżyca, dzisiejsze aspekty planetarne i dopasowanie znaków. Bez konta, bez klucza, bez faktury — jedynym warunkiem jest podanie źródła oraz znacznik canonical, gdy publikujesz pełny tekst.

Wypróbuj

full=1

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

Działa na żywym API prosto z twojej przeglądarki. CORS jest otwarty, więc to jednocześnie działający przykład integracji po stronie klienta.

Punkty końcowe

`GET /api/v1/daily`	lang, sign, full	Dzisiejszy horoskop. Wszystkie dwanaście znaków albo jeden.
`GET /api/v1/weekly`	lang, sign, full	Bieżący tydzień, z kluczem okresu i etykietą zakresu.
`GET /api/v1/monthly`	lang, sign, full	Bieżący miesiąc.
`GET /api/v1/moon`	lang	Oświetlona część, faza, przybywający/ubywający, znak Księżyca. Czysta efemeryda.
`GET /api/v1/cosmic`	lang	Najciaśniejsze aspekty planeta–planeta danego dnia, z orbisami. Czysta efemeryda.
`GET /api/v1/compat`	lang, a, b	Deterministyczne dopasowanie znaków: wynik, przedział, relacja żywiołu i jakości.

Parametry

lang: Jeden z piętnastu obsługiwanych języków (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Wszystko inne przechodzi na angielski zamiast zwracać błąd.
sign: Angielski klucz (leo), angielski slug (leo) albo własny slug danego języka (lew). Pomiń dla wszystkich dwunastu.
full: full=1 zwraca pełny tekst zamiast zajawki. To tryb dystrybucji i włącza obowiązek canonical.
a, b: Tylko dla compat. Dwa znaki, w dowolnej z akceptowanych postaci.

Zajawka albo pełny tekst

Domyślnie każdy element niesie zajawkę — tyle, by wypełnić kartę, pasek boczny albo wiersz kanału. Dodaj full=1, a dostaniesz pełną treść oraz obiekt sections odpowiadający stronie źródłowej. Pełny tekst jest przeznaczony do ponownej publikacji, więc obiekt attribution przestawia canonicalRequired na true i podaje ci dokładny znacznik do wklejenia.

Limit zapytań

10 zapytań na sekundę na adres IP, ze skokiem do 30, egzekwowane na brzegu sieci. Partner dystrybucyjny pobiera raz dziennie na język i nigdy go nie zobaczy. Nie ma limitu dziennego ani kwoty, o którą trzeba wnioskować.

Przykłady

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

curl -s "https://sigastra.com/api/v1/weekly?lang=pl&sign=leo&full=1" | jq '.attribution.canonicalTag'

const res = await fetch("https://sigastra.com/api/v1/daily?lang=pl&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

Warunki w całości

Za darmo dla każdej witryny, komercyjnej i nie. Bez konta, bez klucza, bez cennika.
Pokaż widoczny link „Powered by Sigastra”, do-follow, prowadzący do localizedHref, który zwracamy.
Jeśli publikujesz PEŁNY tekst, dodaj canonicalTag z payloadu do <head> tej strony.
Nie przedstawiaj treści jako obliczonej przez ciebie — ona jest obliczona, a podanie źródła jest tym, co czyni to twierdzenie sprawdzalnym.

API — najczęstsze pytania

Czy API horoskopu jest naprawdę darmowe?+

Tak — bez konta, bez klucza, bez faktury, również dla witryn komercyjnych. Warunki to podanie źródła oraz, przy pełnym tekście, znacznik canonical.

Czy potrzebuję klucza API?+

Nie. Punkty końcowe działają bez klucza, a limit nakładany jest na brzegu sieci. Kształt odpowiedzi już teraz niesie wszystko, do czego klucz mógłby się później podpiąć, więc jego dodanie nie zepsułoby twojej integracji.

Jaki jest limit zapytań?+

10 zapytań na sekundę na adres IP, ze skokiem do 30. Nie ma limitu dziennego.

Czy mogę opublikować cały horoskop ponownie?+

Tak, z full=1 — i wtedy musisz dodać znacznik canonical, który daje ci payload. Bez niego dwie identyczne strony rywalizują, a wyszukiwarka wybiera jedną; canonical sprawia, że ten wybór przestaje być rzutem monetą.

Jakie języki obejmuje API astrologiczne?+

Piętnaście: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Nazwy znaków, planet, aspektów i faz są zlokalizowane.

Czy dane są obliczane, czy pisane?+

Obliczane. Faza Księżyca i aspekty pochodzą wprost z efemeryd; tekst horoskopu powstaje codziennie z rzeczywistych pozycji planet danego dnia i trafia do pamięci podręcznej — API nigdy nie generuje na twoje żądanie, tylko czyta to, co już jest.

Wszystko tutaj jest darmowe. Jedyny warunek to widoczny link do-follow — plus tag kanoniczny, jeśli publikujesz pełny tekst.

Widżety →Syndykacja →WordPress →Przegląd →