🔌 API tính toán miễn phí

Kiểm tra

API chạy chính xác cùng toán học mà trang web sử dụng. Gửi giá trị trường của máy tính như tham số truy vấn hoặc JSON và lấy kết quả tính toán trở lại như JSON — bao gồm bất kỳ lịch trình hủy bỏ hay dữ liệu biểu đồ mà máy tính tạo ra.

• 198+ máy tính, mỗi cái có điểm cuối riêng
• Không có chìa khóa API — truy cập ẩn danh, tốc độ giới hạn bởi IP
• CORS — Access-Control-Allow-Origin: * (có thể dùng bên máy khách)
• Giới hạn tốc độ: 60 yêu cầu/ giờ mỗi IP (HTTP 429 khi vượt quá)

URL cơ sở

https://calculator.free/api/v1/

Tiêu đề — liệt kê mọi máy tính

GET https://calculator.free/api/v1/

Trả lại một danh sách có thể đọc được bởi máy của tất cả các máy tính với các trường của mỗi người (key, label, type, default, unit) và các khóa kết quả - đủ để xây dựng một khách hàng động.

Tính toán — chạy một máy tính

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Hình phản hồi:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Các máy tính toán nhận thức về quốc gia (mượn, vay, thuế thu nhập, thuế bán hàng...) chấp nhận ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug trả về 404; không hỗ trợ quốc gia hoặc nhập sai trả lại 400 với một thông điệp hữu ích và đặc tả trường.

Kế hoạch xác thực

Bạn có thể gọi API mà không cần khóa — yêu cầu ẩn danh bị giới hạn tốc độ theo IP. Để có một hạn mức hàng tháng cao hơn, có thể dự đoán (và sử dụng thương mại), hãy tạo một khóa trên trang tài khoản của bạn và gửi nó theo một trong ba cách sau:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Tự do — ẩn danh (giảm tốc độ IP) hoặc một chìa khóa miễn phí với một số lượng nhỏ hàng tháng. Không thương mại.
• Nhà phát triển — $9/mo — 10.000 cuộc gọi/tháng, sử dụng thương mại.
• Công việc — $49/tháng — 100,000 cuộc gọi/tháng, ưu tiên.

Khi hạn ngạch hàng tháng của một chìa khóa được sử dụng API trả lại HTTP 429 với lỗi "quota_exceeded"; một chìa khóa không rõ hoặc không hoạt động trả lại HTTP 401. Xem kế hoạch đầy đủ và đăng ký trên Giá trang.

Ví dụ

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Tất cả các điểm cuối

Một điểm cuối cho mỗi máy tính. Phím trường và phím kết quả cho mỗi cái là trong /api/v1/ chỉ mục.