Files
sorsfonalak/crates/horoscope-client/src/lib.rs
T
fecoandClaude Opus 5.5 2eea1042a5
CI / test (push) Successful in 1m39s
CI / build (push) Successful in 5m50s
CI / deploy (push) Skipped
Public sign calculator and the twelve sign pages, SEO basics
/aszcendens-kalkulator: Sun, Moon and Ascendant signs from birth data
without an account. A calculation only (no AI, nothing saved), limited to
30 calculations and 300 place searches an hour per visitor address
(POST /v1/public/signs, GET /v1/public/geo/*). Without a birth time there
is no Ascendant, and signs near a border are marked uncertain.

/csillagjegyek and /csillagjegyek/{jegy}: the twelve signs with facts,
Sun, Moon and Ascendant, love, work, a common misbelief and an offer,
each written on its own. Links to the calculator and sign-up.

SEO: metadataBase and canonical addresses, hreflang between the
Hungarian and English privacy pages, Organization and WebSite JSON-LD on
the home page, FAQPage on the calculator, BreadcrumbList on the sign
pages; the sitemap lists the new pages, the footers link them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-21 20:31:45 +00:00

95 lines
3.3 KiB
Rust

//! Client of the horoscope-api service (`POST /v1/natal`, `POST /v1/synastry`).
//!
//! Requests and responses are passed as JSON: the horoscope service validates
//! the birth data itself, and its error objects are handed back unchanged so
//! callers can show them to the user.
use std::time::Duration;
use serde_json::Value;
#[derive(Debug, thiserror::Error)]
pub enum HoroscopeError {
/// The service rejected the input (4xx); `body` is its `{"error": {...}}` object.
#[error("horoscope service rejected the request ({status})")]
Rejected { status: u16, body: Value },
/// The service is unreachable or failed (5xx, timeout, invalid response).
#[error("horoscope service unavailable: {0}")]
Unavailable(String),
}
#[derive(Clone)]
pub struct HoroscopeClient {
base_url: String,
http: reqwest::Client,
}
impl HoroscopeClient {
pub fn new(base_url: impl Into<String>) -> Self {
let http = reqwest::Client::builder()
.timeout(Duration::from_secs(15))
.build()
.expect("static reqwest configuration is valid");
Self { base_url: base_url.into().trim_end_matches('/').to_string(), http }
}
/// `POST /v1/natal`
pub async fn natal(&self, request: &Value) -> Result<Value, HoroscopeError> {
self.post("/v1/natal", request).await
}
/// `POST /v1/synastry`
pub async fn synastry(&self, request: &Value) -> Result<Value, HoroscopeError> {
self.post("/v1/synastry", request).await
}
/// `POST /v1/forecast`
pub async fn forecast(&self, request: &Value) -> Result<Value, HoroscopeError> {
self.post("/v1/forecast", request).await
}
/// `GET /v1/countries`
pub async fn countries(&self) -> Result<Value, HoroscopeError> {
self.get("/v1/countries", &[]).await
}
/// `GET /v1/places?country=&q=&limit=`
pub async fn places(&self, country: &str, query: &str, limit: u32) -> Result<Value, HoroscopeError> {
self.get("/v1/places", &[("country", country), ("q", query), ("limit", &limit.to_string())]).await
}
async fn get(&self, path: &str, query: &[(&str, &str)]) -> Result<Value, HoroscopeError> {
let response = self
.http
.get(format!("{}{path}", self.base_url))
.query(query)
.send()
.await
.map_err(|e| HoroscopeError::Unavailable(e.to_string()))?;
Self::answer(response).await
}
async fn post(&self, path: &str, body: &Value) -> Result<Value, HoroscopeError> {
let response = self
.http
.post(format!("{}{path}", self.base_url))
.json(body)
.send()
.await
.map_err(|e| HoroscopeError::Unavailable(e.to_string()))?;
Self::answer(response).await
}
async fn answer(response: reqwest::Response) -> Result<Value, HoroscopeError> {
let status = response.status();
let body: Value = response.json().await.map_err(|e| HoroscopeError::Unavailable(e.to_string()))?;
if status.is_success() {
Ok(body)
} else if status.is_client_error() {
Err(HoroscopeError::Rejected { status: status.as_u16(), body })
} else {
Err(HoroscopeError::Unavailable(format!("{status}: {body}")))
}
}
}