How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
Numerologia w API: 5 systemów obliczeń jednym trasą
Większość API albo w ogóle nie posiada numerologii, albo oferuje jedną system pifagorejski. My mamy 5 pełnych systemów (pifagorejski, chaldejski, dwa kabałistyczne, wedyjski) po 10 obliczeń każdy, jednym parametryzowanym trasą. Plus Macierz Losu na 22 arkana.
Mapa katalogu: jak zorganizowane są 700+ endpointów AstroWay
API rozrosło się do ponad 700 endpointów w 57 grupach – od mapy natalnej po BaZi, geomantię i renderowanie map SVG. Analizujemy, jak katalog podzielony jest na domeny, według którego jedyny wzorzec stosują wszystkie wywołania i jak szybko znaleźć potrzebny endpoint.
Trzy oficjalne SDK: TypeScript, Python i PHP zamiast surowego curl
Surowe HTTP działa, ale typowany klient oszczędza godziny: podpowiadanie ścieżek, typy żądań i odpowiedzi, wbudowany retry dla 408/409/429/5xx i hierarchia błędów w stylu Stainless. Omawiamy trzy oficjalne SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - i to, jak powstają z jednego kontraktu OpenAPI.
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.
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
X-Cache header: widoczny cache-status do optymalizacji integracji klientów
Każda odpowiedź API teraz zawiera nagłówek X-Cache: MISS | HIT | BYPASS - klient od razu widzi, czy żądanie zostało obliczone od zera, czy pobrane z pamięci podręcznej. To otwiera kolumnę cache hit % w /dashboard/usage i pozwala zoptymalizować integrację bez zgadywania.
Reports V2: jeden endpoint zamiast dwunastu - `/v1/reports/generate`
Zamiast 12 type-specific routów /reports/natal, /reports/synastry, … - jeden ujednolicony endpoint POST /v1/reports/generate z polem report_type. Konsumenci SDK otrzymują jedną metodę zamiast dwunastu; katalog MCP skraca się z 12 narzędzi do jednego.
Astrologia wedyjska przez API: od Parashary do Lal Kitab w 354 endpointach
AstroWay oferuje teraz najpełniejsze pokrycie astrologii wedyjskiej wśród komercyjnych API: 10 systemów dash, 16 varg, Panchang, pełny Lal Kitab + KP + Jaimini. Jak to działa i kiedy wybrać którą technikę.
White-label PDF bez WordPress: inline branding przez jedno pole
Pole whitelabel w schematach wszystkich 12 endpointów /v1/reports/* teraz przyjmuje nie tylko boolean (czytaj konfigurację DB), ale także inline-obiekt z 15 polami. To usuwa powiązanie z użytkownikiem WordPress - dowolny konsument SaaS API może brandować PDF w locie, bez osobnej strony admin.
Jak zbudować aplikację astrologiczną: kompletny przewodnik dla deweloperów
Krok po kroku przewodnik tworzenia aplikacji astrologicznej od podstaw - wybór API, architektura, pierwsza mapa natalska, dodanie synastrii i transytów, wdrożenie.
Szybki start API astrologii: TypeScript i Python w 5 minut
Zainstaluj SDK, pobierz klucz API, wykonaj pierwszy żądanie natalskiej mapy. 5 minut - i działający JSON w rękach (TypeScript i Python).
Rectification API: korekta czasu urodzenia dla deweloperów
Rektifikacja to proces precyzyjnego określenia nieznanego lub niedokładnego czasu urodzenia na podstawie wydarzeń życia. W tym poście - jak zautomatyzować ją za pomocą API z wykorzystaniem metody algorytmicznej i Trutine of Hermes.
Ten sam Swiss Ephemeris, co w Solar Fire - w 4 liniach kodu.
Darmowy klucz bez karty. 5 000 wywołań miesięcznie do pierwszej płatności.