API Oroscopo AI

Dato un segno zodiacale e una data opzionale, l'endpoint compone un prompt e lo instrada attraverso il nostro gateway LLM a un modello linguistico, che scrive un breve oroscopo giornaliero. La risposta contiene il testo dell'oroscopo generato, una dichiarazione di non responsabilità da mostrare insieme, l'identificatore del modello che ha prodotto il testo e la lingua dell'output - localizzata tramite il parametro language, con un default sensibile quando omesso. Poiché un modello linguistico è nel percorso, questo endpoint si comporta diversamente dalle route aritmetiche e delle effemeridi: è più lento, tipicamente da uno a tre secondi, e il testo è una guida appena generata anziché un calcolo riproducibile, quindi due chiamate con input identici possono restituire letture con parole diverse. Gli oroscopi settimanali, mensili e annuali sono endpoint fratelli che condividono lo stesso gateway e struttura.

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sign": "taurus",
  "date": "2026-06-15",
  "language": "en"
}'

{
  "ok": true,
  "data": {
    "horoscope": "Today favours steady progress…",
    "disclaimer": "For entertainment purposes…",
    "model": "gemini-2.5-flash",
    "language": "en"
  }
}

Usa questo quando vuoi copia pronta per la visualizzazione dell'oroscopo senza scrivere o mantenere la tua pipeline di contenuti. Si adatta a superfici di contenuti giornalieri - notifiche push, digest email, schermate iniziali delle app, widget - dove una lettura con parole fresche per segno al giorno è il prodotto. Mostra sempre la dichiarazione di non responsabilità restituita con il testo, e richiedi la lingua di cui hai bisogno tramite il parametro language anziché tradurre lato client. Poiché l'output non è deterministico e la chiamata ha latenza del modello, memorizza nella cache ogni lettura per segno e data una volta generata invece di chiamarla a ogni visualizzazione della pagina, e considera la risposta di uno a tre secondi quando generi su richiesta. Per orizzonti più lunghi, passa agli endpoint fratelli settimanali, mensili o annuali.

Questa è una guida generata, non un calcolo deterministico - input identici possono produrre testi con parole diverse, e la dichiarazione di non responsabilità nella risposta deve essere mostrata agli utenti finali. Il campo model indica il modello selezionato dal gateway, che può variare nel tempo. Si prevede una latenza di circa uno a tre secondi perché un modello linguistico è nel percorso della richiesta; gli endpoint matematici rispondono molto più velocemente.