Σημειώσεις μηχανικής.
Για την ακρίβεια των εφημερίδων, την αρχιτεκτονική υπολογισμών, το πρωτόκολλο MCP και όλες τις λεπτομέρειες που δεν χωρούν στα docs.
Τεκμηρίωση φτιαγμένη για AI agents, όχι μόνο για ανθρώπους
Η κλασική τεκμηρίωση φτιάχνεται για ανθρώπινα μάτια: όμορφο HTML, επισήμανση κώδικα, πλοήγηση. Όμως η μισή κίνηση προς τα docs πλέον είναι agents και βοηθοί, που χρειάζονται plain text και όχι render. Εξηγούμε τι προσθέσαμε: ένα δίδυμο .md για κάθε σελίδα, llms.txt, προδιαγραφές αναγνώσιμες από μηχανές, dropdown "άνοιγμα στο ChatGPT / Claude" και inline try-it.
Διάβασε →Αριθμολογία στο API: 5 συστήματα υπολογισμού με μία διαδρομή
Οι περισσότερες API ή δεν έχουν καθόλου αριθμολογία, ή παρέχουν μόνο ένα πυθαγόρειο σύστημα. Στην πλατφόρμα μας υπάρχουν 5 πλήρη συστήματα (πυθαγόρειο, Χαλδαϊκό, δύο καμπαλιστικά, Βεδικό) με 10 υπολογισμούς το καθένα, μέσω μιας παραμετροποιημένης διαδρομής. Επιπλέον η Μήτρα της Μοίρας για 22 άρκανα.
Διάβασε →Τυποποιημένη έξοδος MCP: γιατί 600+ εργαλεία έχουν outputSchema
Οι περισσότεροι MCP servers δίνουν στον agent JSON χωρίς τύπους, και το μοντέλο πρέπει να μαντέψει τη μορφή της απάντησης. Εμείς δημοσιεύουμε αυστηρό outputSchema για 600+ εργαλεία. Εξηγούμε πώς λειτουργεί, ποιο bug αποκάλυψε στους clients σε strict mode και πώς το διορθώσαμε με ανοιχτά schemas.
Διάβασε →Χάρτα Καταλόγου: πώς είναι οργανωμένοι οι 700+ endpoints του AstroWay
Το API έχει αναπτυχθεί σε πάνω από 700 endpoints σε 57 ομάδες - από γέννημα έως BaZi, γεωμαντεία και απόδοση SVG χαρτών. Αναλύουμε πώς ο κατάλογος χωρίζεται σε τομείς, με ποιο μοναδικό μοτίβο ακολουθούν όλες οι κλήσεις και πώς να βρείτε γρήγορα τον απαιτούμενο endpoint.
Διάβασε →Πώς διατηρούμε την ακρίβεια υπό έλεγχο: CI εναντίον swetest και NASA
Η ακρίβεια στο astro-API υποβαθμίζεται εύκολα από μια μόνο ανασυγκρότηση των εφεμερίδων. Αναλύουμε την προστασία: ένας πυρήνας Swiss Ephemeris για την εφαρμογή και το API, εκατοντάδες παγωμένα snapshots σε πρότυπους χάρτες και τριγωνοποίηση κάθε PR εναντίον swetest CGI, Kerykeion, Prokerala και του καταλόγου σκιών της NASA.
Διάβασε →Τρία επίσημα SDK: TypeScript, Python, PHP αντί για ακατέργαστο curl
Ακατέργαστο HTTP λειτουργεί, αλλά ο τυποποιημένος πελάτης εξοικονομεί ώρες: αυτόματη συμπλήρωση διαδρομών, τύποι αιτήματος και απάντησης, ενσωματωμένο retry σε 408/409/429/5xx και ιεραρχία σφαλμάτων τύπου Stainless. Αναλύουμε τρία επίσημα SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - και πώς δημιουργήθηκαν από ένα OpenAPI συμβόλαιο.
Διάβασε →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
Διάβασε →Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
Διάβασε →