Calculate Four Pillars from any language — no library to install.

# saju.py — requires: pip install requests
import os, requests

BASE = "https://saju-api.pages.dev"

class Saju:
    def __init__(self, api_key):
        self.s = requests.Session()
        self.s.headers["X-API-Key"] = api_key

    def _post(self, path, body):
        r = self.s.post(BASE + path, json=body, timeout=10)
        r.raise_for_status()
        return r.json()

    def _get(self, path, params):
        r = self.s.get(BASE + path, params=params, timeout=10)
        r.raise_for_status()
        return r.json()

    def calculate(self, **b):     return self._post("/api/v1/calculate", b)
    def interpret(self, **b):     return self._post("/api/v1/interpret", b)
    def compatibility(self, **b): return self._post("/api/v1/compatibility", b)
    def daily(self, **p):         return self._get("/api/v1/daily", p)

saju = Saju(os.environ["SAJU_API_KEY"])
chart = saju.calculate(year=1990, month=5, day=15, hour=13, gender="M", lang="en")
print(chart["day_master"])  # {'stem': ..., 'element': 'metal', 'polarity': 'yang'}

// saju.cjs — CommonJS, Node 18+ (global fetch)
const BASE = "https://saju-api.pages.dev";

function createClient(apiKey) {
  async function post(path, body) {
    const res = await fetch(BASE + path, {
      method: "POST",
      headers: { "X-API-Key": apiKey, "Content-Type": "application/json" },
      body: JSON.stringify(body),
    });
    if (!res.ok) throw new Error("saju_api_" + res.status);
    return res.json();
  }
  return {
    calculate:     (b) => post("/api/v1/calculate", b),
    interpret:     (b) => post("/api/v1/interpret", b),
    compatibility: (b) => post("/api/v1/compatibility", b),
  };
}

module.exports = { createClient };

// usage:
// const { createClient } = require("./saju.cjs");
// const saju = createClient(process.env.SAJU_API_KEY);
// const chart = await saju.calculate({ year:1990, month:5, day:15, hour:13, gender:"M" });

// saju.go
package saju

import (
    "bytes"
    "encoding/json"
    "net/http"
)

const base = "https://saju-api.pages.dev"

type Client struct{ key string }

func New(apiKey string) *Client { return &Client{key: apiKey} }

func (c *Client) post(path string, body any, out any) error {
    b, _ := json.Marshal(body)
    req, _ := http.NewRequest("POST", base+path, bytes.NewReader(b))
    req.Header.Set("X-API-Key", c.key)
    req.Header.Set("Content-Type", "application/json")
    res, err := http.DefaultClient.Do(req)
    if err != nil {
        return err
    }
    defer res.Body.Close()
    return json.NewDecoder(res.Body).Decode(out)
}

func (c *Client) Calculate(body map[string]any) (map[string]any, error) {
    var out map[string]any
    err := c.post("/api/v1/calculate", body, &out)
    return out, err
}