API ωροσκοπίων και AI-ερμηνειών

10 AI-ενδπόιντ - μέρος των 700+ ενδπόιντ της πλατφόρμας AstroWay (16 κατηγορίες). 5 για ωροσκόπια (καθημερινά, εβδομαδιαία, μηνιαία, ετήσια, συμβατότητας) και 5 για ερμηνείες (γενέθλιος, συναστρία, διελεύσεις, στοιχείο, τοποθέτηση). Όλα βασίζονται σε πραγματικούς υπολογισμούς του Swiss Ephemeris (του ίδιου που χρησιμοποιείται στο Solar Fire και το Astrodienst) - όχι σε πρότυπα και όχι σε καθαρές ψευδαισθήσεις LLM.

Πώς λειτουργεί

1. Το API υπολογίζει έναν πραγματικό αστρολογικό χάρτη (διελεύσεις, γενέθλιος, συναστρία) μέσω του Swiss Ephemeris
2. Το αποτέλεσμα μεταβιβάζεται στην AI-gateway μας μέσω πολλών κορυφαίων παρόχων LLM με αστρολογικό system prompt και αυτόματη failover
3. Το LLM δημιουργεί κείμενο με ενσωματωμένα safety guardrails (απαγόρευση ιατρικών/νομικών/οικονομικών συμβουλών)
4. Η απάντηση περιλαμβάνει disclaimer και audit trail

Συμβουλή

Τα AI-ενδπόιντ επιστρέφουν τόσο τους υπολογισμούς όσο και το κείμενο. Μπορείς να χρησιμοποιήσεις μόνο τους υπολογισμούς (cheaper endpoints) και να δημιουργήσεις το κείμενο με το δικό σου LLM.

Ενδπόιντ: Ωροσκόπια

Ενδπόιντ	Πιστώσεις	Τι δημιουργεί
/v1/horoscope/daily	50	Καθημερινό ωροσκόπιο βασισμένο στις τρέχουσες διελεύσεις
/v1/horoscope/weekly	50	Εβδομαδιαία επισκόπηση
/v1/horoscope/monthly	50	Μηνιαία πρόβλεψη
/v1/horoscope/yearly	100	Ετήσια πρόβλεψη
/v1/horoscope/compatibility	50	Κειμενική ανάλυση συμβατότητας

Ενδπόιντ: Ερμηνείες

Ενδπόιντ	Πιστώσεις	Τι ερμηνεύει
/v1/interpret/natal	100	Πλήρης ερμηνεία γενέθλιου χάρτη
/v1/interpret/synastry	100	Ερμηνεία συναστρίας
/v1/interpret/transits	100	Ερμηνεία τρεχουσών διελεύσεων
/v1/interpret/element	100	Ερμηνεία μεμονωμένου στοιχείου (πλανήτης σε ζώδιο, όψη)
/v1/interpret/placement	100	Ερμηνεία τοποθέτησης (πλανήτης σε οίκο)

Παράδειγμα

cURL

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sign": "cancer",
    "date": "2026-08-17",
    "language": "uk"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sign: 'cancer',
    date: '2026-08-17',
    language: 'uk',
  }),
});
const { data: horoscope } = await r.json();
console.log(horoscope.horoscope);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/horoscope/daily',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'sign': 'cancer',
        'date': '2026-08-17',
        'language': 'uk',
    },
)
horoscope = r.json()['data']
print(horoscope['horoscope'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('horoscope/daily', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'sign' => 'cancer',
        'date' => '2026-08-17',
        'language' => 'uk',
    ],
]);
$horoscope = json_decode($r->getBody(), true)['data'];
echo $horoscope['horoscope'];

Safety guardrails

Όλα τα AI-ενδπόιντ διαθέτουν ενσωματωμένη προστασία:

• System prompt με ρητή απαγόρευση ιατρικών, νομικών, οικονομικών συμβουλών
• Auto-injected disclaimer σε κάθε απάντηση
• Content filter: μετα-φιλτράρισμα με βάση λέξεις-κλειδιά
• Audit trail: καταγραφή prompts και απαντήσεων (διατήρηση 90 ημερών)
• disclaimer_inline: true: παράμετρος για enterprise που θέλει το κείμενο ήδη με disclaimer

Προσοχή

Οι AI-ερμηνείες προορίζονται για ψυχαγωγικούς σκοπούς. Δεν αντικαθιστούν τη συμβουλή ενός επαγγελματία αστρολόγου, γιατρού, δικηγόρου ή οικονομικού συμβούλου.

Ποιος χρησιμοποιεί

• Πλατφόρμες περιεχομένου: καθημερινά ωροσκόπια για το κοινό
• Αστρολογικές εφαρμογές: εξατομικευμένες ερμηνείες αντί για generic κείμενα
• AI-agents: μέσω MCP server ή απευθείας κλήσης API
• Μέσα ενημέρωσης: δημιουργία αστρολογικού περιεχομένου βασισμένου σε πραγματικά δεδομένα

Κόστος

Το καθημερινό ωροσκόπιο (/v1/horoscope/daily) - 50 πιστώσεις. Η πλήρης ερμηνεία του γενέθλιου χάρτη (/v1/interpret/natal) - 100 πιστώσεις. Στο Free πρόγραμμα, αυτό αντιστοιχεί σε 200 καθημερινά ωροσκόπια ή 100 ερμηνείες ανά μήνα.

Γρήγορη εκκίνηση → Πρώτο αίτημα σε 5 λεπτά

AI-agents και MCP Ενσωμάτωση με Claude, ChatGPT

Τιμολόγηση Από δωρεάν έως Enterprise