Module

Các tính năng của AstroAPI được tổ chức thành các module. Mỗi module mở khóa các endpoint API cụ thể và chức năng cho tổ chức của bạn.

Danh mục Module

Danh mục	Mô tả
calc	Module tính toán — các endpoint tính toán API
texts	Module văn bản nội dung/giải thích
charts	Module hiển thị lá số
addon	Tính năng bổ sung
admin	Công cụ quản trị/quản lý

Các Module Có sẵn

ID Module	Danh mục	Mô tả
module:natal	calc + texts + charts	Tính toán lá số tử vi, giải thích và hiển thị lá số
module:natal-calc	calc	Chỉ tính toán lá số tử vi
module:synastry	calc + texts + charts	Tính toán hợp tinh, giải thích và lá số
module:synastry-calc	calc	Chỉ tính toán hợp tinh
module:transit	calc + texts + charts	Tính toán quá độ, giải thích và lá số
module:transit-calc	calc	Chỉ tính toán quá độ
module:composite	calc + texts + charts	Tính toán lá số kết hợp, giải thích và lá số
module:composite-calc	calc	Chỉ tính toán lá số kết hợp
module:progression	calc	Tiến triển thứ cấp
module:solar-return	calc + texts + charts	Hồi quy mặt trời với giải thích và lá số
module:solar-return-calc	calc	Chỉ tính toán hồi quy mặt trời
module:lunar-return	calc + texts + charts	Hồi quy mặt trăng với giải thích và lá số
module:lunar-return-calc	calc	Chỉ tính toán hồi quy mặt trăng
module:chinese-horoscope	calc	Tính toán cung hoàng đạo Trung Quốc
module:chinese-forecast	calc	Dự báo hàng năm Trung Quốc
module:compatibility	calc	Tương hợp chiêm tinh học
module:moon	calc	Tính toán Mặt Trăng/Mặt Trời và lịch mặt trăng
module:retrograde	calc	Tính toán giai đoạn nghịch hành
module:numerology	calc	Tính toán số học
module:daily-report	texts	Báo cáo tử vi hàng ngày
module:weekly-report	texts	Báo cáo tử vi hàng tuần
module:yearly-report	texts	Báo cáo tử vi hàng năm
module:yearly-ascendant-report	texts	Báo cáo tử vi hàng năm theo cung mọc
module:extra-language	addon	Hỗ trợ ngôn ngữ bổ sung
module:ai-addon	addon	Tính năng chatbot AI
module:embeddable-widgets	addon	Hỗ trợ widget nhúng
module:content-editor	admin	Truy cập trình soạn thảo nội dung

Gói Đăng ký

Mỗi gói đăng ký bao gồm một tập hợp module cố định. Tất cả giá đã bao gồm giảm giá 20%. Module "Full" bao gồm calc + texts + charts. Module "Calc" chỉ bao gồm tính toán.

Tính năng	Basic (€49.99/tháng)	Gold (€112.49/tháng)	Premium (€249.99/tháng)	Deluxe (€374.99/tháng)
Giới hạn tốc độ	60 yêu cầu/phút	120 yêu cầu/phút	300 yêu cầu/phút	600 yêu cầu/phút
Yêu cầu hàng tháng	150K	300K	750K	1M
Natal (calc)	✅	✅	✅	✅
Tương hợp	✅	✅	✅	✅
Mặt Trăng/Mặt Trời	✅	✅	✅	✅
Số học	✅	✅	✅	✅
Trình soạn thảo Nội dung		✅	✅	✅
Natal (full)		✅	✅	✅
Quá độ (calc)			✅	✅
Hồi quy Mặt Trời/Mặt Trăng (calc)			✅	✅
Hợp tinh/Kết hợp (calc)			✅	✅
Tiến triển			✅	✅
Hoàng đạo Trung Quốc			✅	✅
Nghịch hành			✅	✅
Widget Nhúng			✅	✅
Quá độ (full)				✅
Hồi quy Mặt Trời/Mặt Trăng (full)				✅
Hợp tinh/Kết hợp (full)				✅
Dự báo Trung Quốc				✅
Báo cáo Ngày/Tuần/Năm				✅

Kiểm tra Quyền truy cập Module

Liệt kê tất cả các module có sẵn cho tổ chức của bạn:

curl -X GET "https://api.astroapi.cloud/api/modules" \
  -H "X-Api-Key: your-api-key"

Phản hồi

{
  "data": [
    {
      "type": "module",
      "id": "module:natal-calc",
      "attributes": {
        "name": "Natal Chart Calculations",
        "enabled": true,
        "expiresAt": null
      }
    },
    {
      "type": "module",
      "id": "module:transit-calc",
      "attributes": {
        "name": "Transit Calculations",
        "enabled": true,
        "expiresAt": "2024-12-31T23:59:59Z"
      }
    }
  ]
}

Endpoint Yêu cầu Module

Khi truy cập một endpoint yêu cầu module bạn không có:

{
  "errors": [{
    "status": "403",
    "title": "Module Required",
    "detail": "This endpoint requires the 'module:synastry-calc' module.",
    "meta": {
      "requiredModule": "module:synastry-calc"
    }
  }]
}

Quyền hạn API Key

API key có thể bị giới hạn cho các module cụ thể. Ngay cả khi tổ chức của bạn có quyền truy cập vào một module, các API key riêng lẻ có thể được giới hạn để loại trừ nó:

{
  "apiKey": {
    "modules": ["module:natal-calc", "module:moon"]
  }
}

Điều này cho phép bạn tạo các key có phạm vi hạn chế cho các trường hợp sử dụng cụ thể, chẳng hạn như một key chỉ cho phép tính toán lá số tử vi mà không có quyền truy cập vào các module khác mà tổ chức của bạn đã đăng ký.