Ứng dụng chiêm tinh

Bạn đang xây dựng một astro‑ứng dụng giống như Co-Star, Sanctuary, The Pattern, Chani hay Costar Compat? AstroWay API thay thế nhu cầu mua giấy phép Solar Fire ($495) hoặc tự viết engine hiệu chuẩn: 771 endpoint (bản đồ sinh, synastry, transit, Human Design, AI‑interpretations), OpenAPI 3.1 cộng với các SDK đã công bố cho TypeScript, Python và PHP, độ chính xác Swiss Ephemeris – cùng engine như trong Astrodienst và Kepler.

Kiến trúc điển hình

User (browser / mobile)
     ↓
Your backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON response → render in your UI

Chú ý

Không bao giờ đặt API‑key vào mã front‑end. Các cuộc gọi AstroWay API phải đi qua backend của bạn hoặc các hàm server (Next.js API routes, Vercel Functions, AWS Lambda).

Các endpoint chính cho ứng dụng astro

MVP (sản phẩm tối thiểu)

Endpoint	Credits	Mục đích
/v1/chart	20	Xây dựng bản đồ sinh
/v1/synastry	50	Tương hợp của hai người
/v1/horoscope/daily	50	Horoscope hàng ngày

Ba endpoint - và bạn đã có một sản phẩm hoạt động với bản đồ sinh, tính tương hợp và nội dung hàng ngày.

Sản phẩm mở rộng

Endpoint	Credits	Mục đích
/v1/transits	50	Transit hiện tại trên bản đồ sinh
/v1/solar-return	50	Solar return (bản đồ năm)
/v1/progressions	50	Progressions phụ
/v1/interpret/natal	100	AI‑interpretation của bản đồ sinh
/v1/transit-calendar	100	Lịch các sự kiện transit
/v1/human-design	50	Bản đồ Human Design

Tính năng Premium

Endpoint	Credits	Mục đích
/v1/rectification	500	Chỉnh sửa thời gian sinh
/v1/acg	50	Astrocartography (nơi tốt hơn để sống)
/v1/forecast-calendar	100	Dự báo năm - heatmap
/v1/group-synastry	100	Tương hợp nhóm

Đánh giá ngân sách

Kịch bản: 100 DAU (người dùng hoạt động hàng ngày)

Giả sử người dùng trung bình thực hiện 3 hành động mỗi ngày:

Hành động	Endpoint	Credits	Yêu cầu/ngày	Credits/ngày
Xem bản đồ	/v1/chart	20	100	2 000
Horoscope hàng ngày	/v1/horoscope/daily	50	100	5 000
Tương hợp	/v1/synastry	50	30	1 500
Tổng			230	8 500/ngày

~255 000 credits/tháng (8 500 × 30) → gói Pro ($59/tháng, 800 000 credits) với dư thừa lớn, hoặc Starter ($19/tháng, 200 000) với phí overage khoảng ~$30 cho 55K thêm ($5 cho mỗi 10 000 vượt hạn). Cache horoscope hàng ngày (một văn bản cho mỗi cung, không cho từng người dùng) giảm 4 850 credits mỗi ngày và đưa kịch bản về Starter.

Kịch bản: MVP với 20 DAU

Hành động	Credits/ngày
20 bản đồ	400
20 horoscope	1 000
5 synastry	250
Tổng	1 650/ngày

~49 500 credits/tháng - gói Indie ($5/tháng, 50 000 credits) bao phủ 99%, tức là không có dư thừa: bất kỳ tăng trưởng lưu lượng nào đầu tiên sẽ gặp overage hoặc chuyển sang Starter. Với cache horoscope (12 lời gọi mỗi ngày thay vì 20) ra khoảng ~35 000 và có dư thừa.

Mẹo

• Cache bản đồ sinh: đầu vào không thay đổi (ngày sinh không thay đổi), vì vậy kết quả có thể cache vĩnh viễn trong DB của bạn
• Cache horoscope hàng ngày: horoscope hàng ngày giống nhau cho mọi người cùng cung, tạo một lần và phát.
• Sandbox‑key (aw_test_*): dùng cho phát triển, không trừ credits
• Client được kiểu: cài đặt @astroway/sdk, astroway hoặc astroway/sdk; với ngôn ngữ khác tạo client từ /v1/openapi.json bằng openapi-typescript hoặc openapi-python-client

Bắt đầu nhanh → Yêu cầu đầu tiên trong 5 phút

Birth Chart API Chi tiết về bản đồ sinh

Gói cước Từ miễn phí đến Enterprise