이용 가능개발자·AI

계산 API

환불 16종, 지연이자, 대출 상환, 수당·퇴직금, 급여명세서, 프리랜서 3.3%, 임대차 갱신까지 24개 계산을 JSON으로 호출해요. 문장 답변과 숫자 결과가 함께 와서 그대로 화면이나 대화에 쓸 수 있어요.

키 신청 바로 써 보기

주요 기능

문장 + 숫자

응답에 사람이 읽는 답변(answer)과 계산 값(result), 근거(basis)가 같이 와요.

24개 계산

헬스장·학원·여행·예식·숙박·상조 환불부터 지연이자, 중개보수, 대출 상환, 퇴직금, 급여명세서, 임대차 갱신까지 있어요.

사용량 확인

응답 헤더 x-quota-used로 이번 달 사용량을 바로 볼 수 있어요.

월 50,000회

한도를 넘으면 429로 알려요. 더 필요하면 문의해 주세요.

공개 명세

OpenAPI 문서로 도구 이름과 입력 항목을 확인할 수 있어요.

AI 연결

키 없이 쓰는 MCP 입구(tool.avenpa.com/mcp)도 열려 있어요.

이렇게 써요

키 신청

업체명과 이메일을 보내 주세요.

호출해 보기

아래 예시를 터미널에 붙여 넣어 응답을 확인하세요.

서비스에 연결

도구 이름과 입력 항목은 openapi.json에 있어요.

API 사용법

호출 예시

curl -H "Authorization: Bearer 발급받은키" \
  "https://business.avenpa.com/api/v1/calc/calc_gym_refund?total_price=360000&start_date=2026-01-01&end_date=2026-12-31&cancel_date=2026-06-30"

응답 예시

{
  "answer": "소비자 사유 해지: 환급액은 145,479원입니다 …",
  "result": { "usedDays": 181, "used": 178521, "penalty": 36000, "refund": 145479, "payout": 145479 },
  "basis": "…"
}

POST로 JSON 본문을 보내도 돼요. 키는 Authorization 헤더 또는 key 파라미터로 넣어요.

도구 이름 (앞에 calc_ 를 붙여 호출)

gym_refundacademy_refundtravel_cancel_feepostpartum_refundwedding_cancel_feerental_cancel_feestudyroom_refundlodging_cancel_feeshow_ticket_cancel_feemoving_cancel_feecar_rental_refundinsurance_withdraw_deadlinegift_certificate_refundsangjo_cancel_refundrealestate_brokerage_feegolf_cancel_feelate_interestloan_scheduleprepay_feeovertime_payseverancepayroll_slipfreelancer_taxlease_renewal

입력 항목은 openapi.json, AI용 안내는 llms.txt에서 확인하세요.

오류 코드

401	키가 없거나 올바르지 않아요.
403	이 키의 플랜에는 API가 포함되어 있지 않아요(위젯 키).
429	이번 달 호출 한도를 넘었어요.

자주 묻는 질문

키 없이 쓸 수 있나요?

tool.avenpa.com/api/calc는 키 없이 열려 있어요. 이쪽은 사용량 확인과 한도 안내가 붙는 키 전용 입구예요.

한도를 넘으면 어떻게 되나요?

그 달 남은 기간 동안 429 응답이 와요. 매월 1일(UTC)에 다시 세요.

가격은 얼마인가요?

지금은 베타예요. 가격은 베타 이후에 정하고 미리 알려 드려요.

계산 결과의 책임은요?

참고용 계산이에요. 계약서의 특약이나 면책 사유는 반영하지 않아요.