🔌 무료 계산기 API

개요

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

• 198+ 계산기, 각각 자체 엔드포인트
• API 키 없음 — 익명 접속, IP에 의해 속도 제한
• CORS — Access-Control-Allow-Origin: * (사용 가능한 클라이언트 측)
• 속도 제한: 60 IP당 요청/시간 (초과 시 HTTP 429)
• 오류는 무료입니다 — 성공적인 응답(2xx)만이 월간 할당량에서 1번의 호출을 사용합니다. 400, 401, 404, 429, 500은 무료입니다.

기본 URL

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

색인 — 모든 계산기 목록

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

각각의 필드(키, 라벨, 타입, 기본값, 단위)와 결과 키가 있는 모든 계산기의 기계 읽기 가능한 목록을 반환합니다. 클라이언트를 동적으로 구축하기에 충분합니다. 각 필드는 또한 필요한 플래그를 가지고 있습니다. true 는 기본값이 없는 몇몇 필드에 대해서만 적용됩니다. 이 필드를 보내면 몇몇 계산기는 하나를 추론할 수 있고 나머지는 400이 아닌 답을 얻습니다.

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

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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

파라미터, 기본값 및 오류

관심 있는 필드만 보내세요. 빠뜨린 필드는 해당 필드의 게시 기본값으로 채워집니다. 계산기 페이지에서 미리 채우는 값과 동일하므로 API와 웹사이트는 동일한 입력에 대해 항상 동일한 숫자를 반환합니다. 각 응답은 아래에 채워진 내용을 나열합니다. defaults_applied.

API가 정직하게 해결할 수 없는 모든 것은 0이 아닌 오류입니다. 철자가 잘못된 매개변수, 잘못된 유형의 값, 알 수 없는 드롭다운 옵션, 기본값이 없는 누락된 필드(날짜 필드 - 생년월일은 추측할 수 없음) 등이 그것입니다. 400번마다 클라이언트가 스스로를 수정할 수 있도록 침해된 매개변수의 이름과 전체 필드 사양을 반복합니다.

$ curl "https://calculator.free/api/v1/mortgage/?price=350000&rate=6.5&term=30"
{
  "ok": false,
  "error": "unknown_parameter",
  "message": "Unknown parameter 'term' for calculator 'mortgage'. Did you mean 'years'? ...",
  "unknown_parameters": ["term"],
  "did_you_mean": { "term": "years" },
  "valid_parameters": ["down", "extra", "extra_onetime", "extra_yearly", "hoa",
                       "insurance", "other", "pmi", "price", "rate", "tax", "years"],
  "fields": [ ... ]
}

너희들 /api/v1/ index는 모든 필드의 키, 타입, 단위, 기본값, 필요 여부를 게시합니다.

인증 & 계획

익명 요청은 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 통화/월, 우선 처리량.

할당량에 포함되는 항목

성공적인 응답만이 효과가 있습니다. 2xx 하나 = 1번의 호출. 모든 오류는 무료입니다. 철자 오류가 있는 매개변수, 잘못된 값 또는 필수 필드가 누락된 경우 400, 알 수 없는 슬래그에 대한 404, 잘못된 키에 대한 401, 429, 그리고 우리 측에서 잘못된 모든 것. 계약을 탐색하고 필요한 만큼 요청을 수정하세요.

오류는 무료이기 때문에 대신 속도 제한이 있다: 한 키가 보다 더 많은 것을 유발한다면 200 1시간 동안 응답을 거부하면 시간이 지나기 전까지 HTTP 429 "too_many_invalid_requests" 를 받습니다. 성공적인 호출은 이 값에 포함되지 않으므로, 작동하는 통합은 이 값을 보지 못합니다.

키의 월간 할당량이 사용되면 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);

Python

import requests

r = requests.get("https://calculator.free/api/v1/mortgage/",
                 params={"price": 350000, "down": 70000,
                         "rate": 6.9, "years": 30},
                 headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["results"])

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/ 인덱스.