🔌 무료 계산기 API

개요

API는 웹사이트에서 사용하는 것과 동일한 수학을 실행합니다. 계산기의 필드 값을 쿼리 매개 변수 또는 JSON으로 보내고 계산 결과를 JSON으로 얻습니다. 계산기에서 생성한 모든 매각 일정 또는 차트 데이터를 포함합니다.

• 198+ 계산기, 각각 자체 엔드포인트
• API 키 없음 — 익명 접속, IP에 의해 속도 제한
• CORS — Access-Control-Allow-Origin: * (사용 가능한 클라이언트 측)
• 속도 제한: 60 IP당 요청/시간 (초과 시 HTTP 429)

기본 URL

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

색인 — 모든 계산기 목록

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

각각의 필드(키, 라벨, 타입, 기본값, 단위)와 결과 키가 있는 모든 계산기의 기계 읽기 가능한 목록을 반환합니다. 클라이언트를 동적으로 구축하기에 충분합니다.

계산 — 하나의 계산기를 실행

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

응답 형태:

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

국가 인식 계산기 (모기지, 대출, 소득세, 판매세...) 허용 ?country=us|uk|ca|au|in|ie|nz|za. 알 수 없는 슬러그는 404를 반환합니다. 지원되지 않는 국가 또는 잘못된 입력은 도움말 메시지와 필드 스펙과 함께 400을 반환합니다.

인증 & 계획

익명 요청은 IP에 따라 속도가 제한되므로 키 없이도 API를 호출할 수 있습니다. 예측 가능한 월별 할당량(상업용)을 높이려면 계정 페이지에서 키를 만들고 다음 세 가지 방법 중 하나로 보내십시오.

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"

• 자유 — 익명 (IP 속도 제한) 또는 작은 월간 할당량과 무료 키. 비상업적.
• 개발자 — $9/월 — 10,000 통화/월, 상업용.
• 비즈니스 — $49/월 — 100,000 통화/월, 우선 처리량.

키의 월간 할당량이 사용되면 API는 HTTP 429와 오류 "quota_exceeded"를 반환합니다. 알 수 없거나 비활성 키는 HTTP 401을 반환합니다. 전체 플랜을 보고 가입하십시오. 가격 페이지.

예제

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}'

모든 엔드포인트

계산기당 하나의 엔드포인트. 각각의 필드 키와 결과 키는 표 1에 나와 있습니다. /api/v1/ 인덱스.