문서 섹션

할당량과 제한

제한은 두 가지입니다. 계정에 속하는 월간 호출 할당량, 그리고 요청이 지닌 자격 증명에 따라 정해지는 분당 요청 수입니다. 남은 양을 확인하는 것은 집계되지 않습니다.

월간 할당량(계정별)

할당량은 키가 아니라 계정에 속하며, 모든 키의 호출이 하나의 수치에서 차감됩니다. 할당량은 UTC 기준으로 매월 초에 초기화됩니다. 거부된 호출(키 누락 또는 잘못된 키, 알 수 없는 계산기, 해석할 수 없는 본문)은 비용이 들지 않으며, 집계된 뒤 서비스 쪽에서 실패한 호출은 되돌려집니다.

요금제별 월간 할당량
요금제	월간 호출 수	키	배치 엔드포인트
Free	5	API 키 1개	아니요
Pro · 월 $9	100	API 키 3개	아니요
API · 월 $19	10,000	API 키 5개	예, 요청당 최대 50건

할당량을 다 쓰면 402이며, 401이나 429가 아닙니다. 오류를 참고하세요.

사용량

GEThttps://rftools.io/api/py/v1/usage

GET /api/py/v1/usage는 키나 로그인한 세션에 대해, 계정이 이번 달에 쓴 양과 남은 양, 초과 사용 상태, 각 키에 기록된 호출을 반환합니다. 이 조회는 집계되지 않으므로, 프로그램은 분당 제한 안에서 남은 호출 수를 원하는 만큼 자주 표시할 수 있습니다.

일별 시계열

?days=N(1~90의 정수)을 붙이면 응답에 daily가 추가됩니다. 오래된 것부터 오늘(UTC) 날짜까지 정확히 N개의 {date, calls} 항목이 나옵니다. 호출이 없는 날은 0으로 표시됩니다. 각 날의 값은 계정의 모든 키 호출에서 되돌려진 호출을 뺀 것입니다. days가 없으면 응답은 바뀌지 않습니다.

사용량 응답 필드
필드	설명
tierstring	계정의 요금제: free, pro 또는 api.
periodstring	달력상의 월, YYYY-MM(UTC).
resetAtstring	할당량이 초기화되는 시점: 다음 달의 첫 순간.
allowance, used, remaininginteger	그 달의 할당량, 되돌려진 호출을 뺀 집계된 호출 수, 남은 양.
overageobject	종량제 초과 사용: 계정이 대상인지, 켜져 있는지, 사용량과 상한.
keysarray	계정의 각 키: keyId, label, client, active, used, lastUsedAt.
rateLimitPerMinuteinteger	요청이 지녔던 자격 증명의 분당 제한.
daily{date, calls}[]	?days=N을 붙인 경우에만: 최근 N일(UTC) 각각의 호출 수.

사용량 헤더

집계되는 모든 응답(계산기 호출, 배치, 키로 제출한 작업)에는 브라우저가 읽을 수 있는 헤더에 같은 수치가 담깁니다:

사용량 헤더
헤더	의미
X-Usage-Allowance	계정의 월간 할당량.
X-Usage-Used	이번 달 집계된 호출 수(이 호출 포함).
X-Usage-Reset	할당량이 초기화되는 시점(ISO-8601, UTC): 다음 달의 첫 순간.
X-Usage-Overage	이번 달 종량제 초과 사용이 집계된 경우에만 있음: 그 호출 수.

분당 요청 수(주소별)

분당 제한은 요금제가 아니라 요청이 지닌 자격 증명에 따라 정해집니다. 제한을 넘으면 API는 Retry-After 헤더와 함께 429로 응답합니다. 디바이스 권한 부여 엔드포인트에는 무엇을 보내든 자격 증명 없는 요청의 제한이 적용됩니다.

분당 속도 제한
요청이 지닌 것	분당 요청 수
자격 증명 없음	30
로그인한 세션	60
API 키	120

기타 제한

배치 하나에는 최대 50건의 계산을 담을 수 있습니다. 배치를 참고하세요.
호출자마다 대기 중이거나 실행 중인 시뮬레이션 작업은 동시에 3개까지입니다. 시뮬레이션 작업을 참고하세요.

GET /api/py/v1/usage?days=7

curl "https://rftools.io/api/py/v1/usage?days=7" \
  -H "X-API-Key: $RFTOOLS_API_KEY"

import os

import httpx

response = httpx.get(
    "https://rftools.io/api/py/v1/usage?days=7",
    headers={"X-API-Key": os.environ["RFTOOLS_API_KEY"]},
)
print(response.status_code, response.json())

const response = await fetch("https://rftools.io/api/py/v1/usage?days=7", {
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
  },
});
console.log(response.status, await response.json());

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://rftools.io/api/py/v1/usage?days=7", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "tier": "pro",
  "period": "2026-09",
  "resetAt": "2026-10-01T00:00:00+00:00",
  "allowance": 100,
  "used": 37,
  "remaining": 63,
  "overage": {
    "eligible": false,
    "active": false,
    "used": 0,
    "cap": 50000,
    "reportedThisPeriod": null,
    "manageUrl": null
  },
  "keys": [
    {
      "keyId": "rfc_AbCdEfGh",
      "label": "kicad-plugin — 2026-09-02",
      "client": "kicad-plugin",
      "active": true,
      "used": 37,
      "lastUsedAt": "2026-09-23T14:05:11+00:00"
    }
  ],
  "rateLimitPerMinute": 120,
  "daily": [
    {
      "date": "2026-09-18",
      "calls": 3
    },
    {
      "date": "2026-09-19",
      "calls": 0
    },
    {
      "date": "2026-09-20",
      "calls": 5
    },
    {
      "date": "2026-09-21",
      "calls": 8
    },
    {
      "date": "2026-09-22",
      "calls": 2
    },
    {
      "date": "2026-09-23",
      "calls": 6
    },
    {
      "date": "2026-09-24",
      "calls": 4
    }
  ]
}

days가 없으면 daily를 뺀 같은 본문입니다.

{
  "detail": "This account's 100 API calls for September are used. They reset on 2026-10-01. The API plan includes 10,000 a month.",
  "errorKind": "rate_limited",
  "reason": "allowance",
  "limit": 100,
  "used": 100,
  "upgradeUrl": "https://rftools.io/pricing/",
  "overageUrl": null,
  "resetAt": "2026-10-01T00:00:00+00:00"
}

할당량을 다 쓴 뒤 집계되는 호출에서 반환되며, Retry-After에 resetAt까지 남은 초가 담깁니다.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

1분 동안 요청이 너무 많습니다. Retry-After가 함께 옵니다.