Số học trong API: 5 hệ thống tính toán qua một route

Нumerology - là một phần của ngăn xếp esoteric, mà API thường hoặc bỏ qua hoàn toàn, hoặc chỉ giảm xuống một «số đường đời» Pythagorean. Chúng mình đã đi con đường khác: 5 hệ thống đầy đủ, mỗi hệ thống có 10 phép tính chuẩn, tất cả dưới một route tham số hoá.
Cùng nhau có 50 endpoint dưới /numerology/{system}/{calc}, cộng thêm một Destiny Matrix riêng. Dưới đây là cách nó được sắp xếp và tại sao chỉ cần một route.

Tất cả các phép tính đều nằm dưới mẫu:

POST /v1/numerology/{system}/{calc}

{system} - một trong năm giá trị. Mỗi hệ thống có bảng ánh xạ riêng «chữ cái → số» và quy tắc giảm riêng, vì vậy kết quả cho cùng một tên sẽ khác nhau tùy vào trường học:

Hệ thống không biết sẽ trả về 400 INVALID_SYSTEM kèm danh sách các giá trị hợp lệ - không có fallback im lặng nào sang Pythagorean.

Bộ 10 phép tính này có sẵn cho bất kỳ trong năm hệ thống:

• life-path - số đường đời (từ ngày sinh)
• expression - số biểu hiện / số phận (từ tên đầy đủ)
• soul-urge - số linh hồn (chữ nguyên âm trong tên)
• personality - số cá tính (chữ phụ âm trong tên)
• birthday - số ngày sinh
• maturity - số trưởng thành (đường đời + biểu hiện)
• balance - số cân bằng (chữ cái đầu)
• challenge - số thách thức
• pinnacles - số đỉnh (giai đoạn cuộc đời)
• personal-year - số năm cá nhân

Body của request cho hầu hết các gọi là chỉ tên và ngày sinh:

{ "name": "Ada Lovelace", "date": "1815-12-10" }

personal-year còn nhận thêm year, vì nó tính rung động của năm lịch cụ thể.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace","date":"1815-12-10"}'

Response chứa không chỉ số mà còn toàn bộ chuỗi giảm và giải thích sẵn:

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1815-12-10",
    "lifePath": {
      "raw": 10,
      "reduced": 1,
      "isMaster": false,
      "steps": [10, 1],
      "meaning": {
        "number": 1,
        "archetype": "The Pioneer",
        "strengths": ["leadership", "independence", "innovation", "initiative"],
        "challenges": ["ego", "impatience", "isolation", "stubbornness"],
        "career": ["entrepreneur", "executive", "inventor", "pioneer"],
        "relationship": "needs a partner who respects independence; thrives on mutual challenge",
        "shortRead": "born to lead and originate; learn to balance solo drive with collaboration"
      }
    }
  }
}

Trường steps hiển thị mỗi bước giảm (10 → 1), và isMaster bật ở 11, 22 và 33 - chúng không được giảm theo quy ước Pythagorean. Điều này quan trọng nếu bạn xây dựng UI riêng: không cần đoán tại sao 29 thành 11 chứ không phải 2 - chuỗi được trả về rõ ràng.

Destiny Matrix - không phải là một phần của số học cổ điển, vì vậy nó tồn tại trên route riêng:

POST /v1/destiny-matrix

Đây là phương pháp dựa trên 22 Arcana lớn của Tarot, được sắp xếp thành octagram từ ngày sinh. Trả về vị trí của dấu thập trung tâm, các đường tổ tiên, khu vực tiền bạc và quan hệ - một cấu trúc sẵn sàng để render ma trận. Chúng mình giữ nó ngoài /numerology/* vì đây là mô hình khác (arcana, không phải giảm số).

Các phép tính số học - chỉ là phép tính số học thuần trên chuỗi và ngày, không có hiệu ứng thiên văn. Vì vậy chúng quyết định và rẻ: cùng một input luôn cho cùng một output, caching đơn giản. Các giải thích (meaning) là bảng tĩnh, không phải LLM, vì vậy không có ảo giác hay biến đổi giữa các lần gọi.

Nếu cần văn bản tự do trên các số, đó là layer /interpret/* riêng với AI - nhưng các số cơ bản luôn đến từ lõi quyết định.

Số học là một phần của gói add‑on esoteric cùng với Tarot, rune, geomanthia và I Ching. Mỗi gọi có chi phí tín dụng cố định (tính toán, không phải AI‑endpoint, vì vậy rẻ). Gói miễn phí - 10 000 credit mỗi tháng, đủ để thu thập hồ sơ số học đầy đủ cho vài trăm người dùng mỗi tháng mà không cần trả phí.

1. Khóa tại dashboard/sign-up
2. Chọn hệ thống phù hợp với khán giả của bạn (Pythagorean - mặc định cho thị trường phương Tây, Vedic - cho thị trường Ấn Độ)
3. Thu thập hồ sơ với 10 gọi hoặc kéo từng số cho màn hình cụ thể

Danh sách đầy đủ các trường và schema - trong OpenAPI‑guide dưới nhóm Numerology.