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.
API의 점술학: 하나의 라우트로 5가지 계산 시스템
대부분의 API는 점술학을 전혀 제공하지 않거나, 피타고라스 시스템 하나만 제공합니다. 저희는 5개의 완전한 시스템(피타고라스, 칼데아, 카발라 2가지, 베다)을 각각 10개의 계산과 함께 하나의 매개변화된 라우트로 제공합니다. 더불어 22장의 운명 매트릭스도 포함됩니다.
카탈로그 지도: AstroWay의 700개 이상 엔드포인트는 어떻게 구성되어 있나
API는 57개 그룹, 700개 이상의 엔드포인트로 성장했습니다. 출생 차트부터 BaZi, 지점술, SVG 차트 렌더링까지 다룹니다. 카탈로그가 어떻게 도메인으로 나뉘는지, 모든 호출이 따르는 단 하나의 패턴은 무엇인지, 필요한 엔드포인트를 어떻게 빠르게 찾는지 살펴봅니다.
세 가지 공식 SDK: 순수 curl 대신 TypeScript, Python, PHP
순수 HTTP로도 동작하지만, 타입이 있는 클라이언트는 몇 시간을 아껴 줍니다: 경로 자동 완성, 요청과 응답 타입, 408/409/429/5xx에 대한 내장 재시도, Stainless 스타일의 오류 계층. 세 가지 공식 SDK인 @astroway/sdk(npm), astroway(PyPI), astroway/sdk(Packagist)를 살펴보고, 이들이 어떻게 하나의 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: 가시적인 cache-status를 통한 클라이언트 통합 최적화
각 API 응답은 이제 X-Cache: MISS | HIT | BYPASS 를 포함합니다 - 클라이언트는 요청이 처음부터 계산되었는지, 캐시에서 가져왔는지 즉시 확인할 수 있습니다. 이는 /dashboard/usage 의 cache hit % 열을 열어주며 guesswork 없이 통합을 최적화할 수 있게 합니다.
Reports V2: 12개 대신 하나의 엔드포인트 - `/v1/reports/generate`
12개의 type-specific 라우트 /reports/natal, /reports/synastry, … 대신 하나의 통합 엔드포인트 POST /v1/reports/generate (report_type 필드 포함). SDK 소비자는 12개 대신 하나의 메서드를 받으며; MCP 카탈로그는 12개의 도구에서 하나로 축소됩니다.
API로 만나는 베다 점성술: 파라샤라부터 랄 키탑까지 354개 엔드포인트
AstroWay는 이제 상용 API 중 가장 폭넓은 베다 점성술 커버리지를 제공합니다: 10가지 다샤 체계, 16개 바르가, 판창, 완전한 랄 키탑 + KP + 자이미니. 작동 방식과 기법별 선택 기준을 정리했습니다.
White-label PDF WordPress 없이: inline branding 단일 필드로
whitelabel 필드가 모든 12개의 엔드포인트 /v1/reports/* 스키마에서 이제 boolean만 받는 것이 아니라 15개의 필드를 가진 inline-객체를 받습니다. 이는 WordPress 사용자와의 연계를 해제하여, 어떤 SaaS 소비자 API도 별도의 admin 페이지 없이 실시간으로 PDF를 브랜딩할 수 있게 합니다.
아스트로로지 애플리케이션 구축 가이드: 개발자를 위한 완전한 가이드
아스트로로지 애플리케이션을 처음부터 만드는 단계별 가이드 - API 선택, 아키텍처, 첫 번째 내태아 도표, 시나스트리 및 트랜짓 추가, 배포
아스트로로지 API 빠른 시작: TypeScript 및 Python 5분 안에
SDK 설치, API 키 받기, 첫 번째 내태아 도표 요청하기. 5분 안에 작동하는 JSON을 손에 넣을 수 있습니다(TypeScript 및 Python).
Rectification API: 개발자를 위한 출생 시간 수정
Rectification은 알려지지 않은 또는 부정확한 출생 시간을 삶의 사건에 따라 수정하는 과정입니다. 이 게시물에서는 알고리즘 방법과 Trutine of Hermes를 사용하여 API를 통해 이를 자동화하는 방법에 대해 설명합니다.
Solar Fire에 사용된 것과 동일한 Swiss Ephemeris - 단 4줄의 코드로.
카드 없이 무료 키. 첫 결제 전까지 월 5,000 API 호출.