AstroWay/api v2.173.1 · vi
tất cả hệ thống hoạt động bình thường
// astrology api · POST /v1/acg/by-category

API diễn giải Astrocartography

Đường hình học đơn lẻ không cho người dùng biết mình nên di chuyển đâu. Endpoint này nhận một lĩnh vực cuộc sống, chọn các đường astrocartography thực sự chi phối nó, xếp hạng chúng theo mức độ mạnh và mức độ gần gũi, và trả về văn bản diễn giải cho mỗi đường. Một lần gọi thay thế việc ánh xạ hành tinh-đối-chủ đề mà mọi sản phẩm relocation phải tự tạo.

Endpoint
POST /v1/acg/by-category
Cost
50 credits
Latency
~210 ms
Tier
Tier 3
// 01 / What it computes

API diễn giải Astrocartography

Endpoint tính toàn bộ bộ astrocartography cho thời điểm sinh, sau đó lọc qua taxonomy gồm mười chín lĩnh vực cuộc sống dựa trên tài liệu nền tảng của kỹ thuật: Jim Lewis cho ý nghĩa hành tinh-trên-góc, Erin Sullivan cho những gì bốn góc điều khiển, và Martin Davis cho cách xử lý các đường khó. Mỗi lĩnh vực đặt tên các đường thuộc nó với trọng số từ một tới ba, nên Mặt Trời trên Đỉnh Midheaven vượt trội hơn Sao Thủy trên cùng góc cho sự nghiệp. Mỗi ánh xạ còn có polarity, và các đường thách thức được trả về cùng với các đường hỗ trợ thay vì bị lọc, vì công cụ relocation chỉ hiển thị các đường thuận lợi sẽ làm sai lệch kỹ thuật. Khi bạn truyền một điểm, các đường ngoài bán kính bị loại và độ mạnh trả về nhân trọng số chiêm tinh với khoảng cách địa lý, cho phép bạn xếp hạng các thành phố ứng viên thay vì chỉ liệt kê các đường. Văn bản diễn giải được cung cấp từ knowledge base được biên tập, bao phủ tất cả bốn mươi kết hợp hành tinh-góc bằng mười một ngôn ngữ, với fallback được ghi chép khi thiếu bản dịch.

// 02 / Live request

POST/v1/acg/by-category

curl -X POST https://api.astroway.info/v1/acg/by-category \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "category": "career",
  "point": { "lat": 51.5074, "lng": -0.1278 },
  "radiusDeg": 8,
  "language": "en"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "category": { "id": "career", "name": "Career" },
    "language": "en",
    "count": 3,
    "lines": [
      {
        "planet": "Jupiter",
        "type": "MC",
        "weight": 3,
        "polarity": "supportive",
        "strength": 2.31,
        "distanceDeg": 1.84,
        "pointCount": 341,
        "segments": [
          [[-85, 110.48], [-84.5, 110.48], "…"]
        ],
        "interpretation": {
          "title": "Jupiter - MC",
          "text": "Expansion of professional opportunity…",
          "lang": "en"
        }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment.
latitude number yes Birth-place latitude, decimal degrees.
longitude number yes Birth-place longitude, decimal degrees.
category string yes One of 19 life areas: career, love, money, health, home, learning, power, travel and more. Fetch the full list from GET /v1/acg/categories.
point { lat, lng } no Optional geographic focus. With it, only lines running within radiusDeg of that point are returned and strength folds in proximity.
radiusDeg number no Search radius in degrees around point. Default 4, range 0.5 to 20.
polarity string no supportive, challenging, or all (default). Challenging lines are returned by default rather than hidden.
includeText boolean no Attach the interpretation text for each line. Default true.
includeCoordinates boolean no Attach the line geometry as `segments`, an array of `[lat, lng]` polylines. A rising or setting curve is several disjoint segments, so they are kept separate rather than concatenated. Default true; set false for a compact ranking response.
language string no Interpretation language. Falls back to English then Ukrainian when a translation is missing, and the served language is reported per line.
// 04 / When to use it

When to use it

Sử dụng khi sản phẩm của bạn trả lời câu hỏi bằng ngôn ngữ thường: mình nên đi đâu để làm việc, trong ba thành phố nào tốt nhất cho mối quan hệ, đường này trên thành phố mình thực sự có nghĩa là gì. Ba dạng bao phủ hầu hết các build. Xếp hạng bằng cách gửi một category và một point cho mỗi thành phố ứng viên rồi sắp xếp theo strength. Giải thích bằng cách gọi /v1/acg/line-report cho một hành tinh và góc duy nhất để lấy toàn bộ text cộng với mọi lĩnh vực cuộc sống khác mà đường đó chạm tới. Khám phá bằng cách GET /v1/acg/categories một lần khi không có credit và xây UI từ taxonomy trả về để category mới xuất hiện mà không cần phát hành client. Vì text được biên tập chứ không sinh ra, phản hồi quyết định, không trích dẫn model, và không tốn thêm chi phí inference: cùng một request sẽ trả về cùng từ ngày mai.

// 05 / Notes

Notes

Taxonomy bao phủ mười thiên thể truyền thống. Chiron, Lilith và các nút mặt trăng xuất hiện trong geometry /v1/acg nhưng được để ngoài mapping cố ý, vì kỹ thuật do Jim Lewis định nghĩa không gán chúng quyền lực góc-lĩnh vực cuộc sống. Trọng số và polarity là phán đoán biên tập được biểu thị dưới dạng dữ liệu, versioned trong repository và có thể audit thay vì ẩn trong prompt. Văn bản diễn giải là tra cứu knowledge-base, không phải lời gọi language-model, vì vậy nó ổn định, có thể tái tạo offline và không có các disclaimer mà diễn giải sinh ra yêu cầu.

Try the Diễn giải Astrocartography API

Grab a key and make your first call in under a minute.

99,9% SLA · gói trả phí · 30 ngày trạng thái →