Abschnitte der Dokumentation

Kontingente und Limits

Zwei Limits gelten: ein monatliches Kontingent an Aufrufen, das dem Konto gehört, und eine Zahl von Anfragen pro Minute, die sich nach den Zugangsdaten der Anfrage richtet. Das Abfragen des Restkontingents wird nie gezählt.

Monatliches Kontingent, pro Konto

Das Kontingent gehört dem Konto, nicht einem Schlüssel: Die Aufrufe all seiner Schlüssel werden auf einen gemeinsamen Wert angerechnet. Es wird zu Beginn jedes Kalendermonats in UTC zurückgesetzt. Ein abgelehnter Aufruf (ein fehlender oder ungültiger Schlüssel, ein unbekannter Rechner, ein nicht lesbarer Body) kostet nichts, und ein Aufruf, bei dem der Dienst nach dem Zählen scheitert, wird gutgeschrieben.

Monatliches Kontingent pro Tarif
Tarif	Aufrufe pro Monat	Schlüssel	Batch-Endpunkt
Free	5	1 API-Schlüssel	Nein
Pro · $9 pro Monat	100	3 API-Schlüssel	Nein
API · $19 pro Monat	10.000	5 API-Schlüssel	Ja, bis zu 50 pro Anfrage

Ein verbrauchtes Kontingent ist 402, nie 401 oder 429; siehe Fehler.

Nutzung

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

GET /api/py/v1/usage nennt einem Schlüssel oder einer angemeldeten Sitzung, was das Konto in diesem Monat verbraucht hat und was übrig ist, den Stand der Mehrnutzung und die Aufrufe, die jedem seiner Schlüssel zugeordnet sind. Die Abfrage wird nie gezählt, sodass ein Programm seine verbleibenden Aufrufe so oft anzeigen kann, wie es will, innerhalb des Limits pro Minute.

Die tägliche Reihe

Fügen Sie ?days=N hinzu, eine ganze Zahl von 1 bis 90, und die Antwort erhält daily: genau N Einträge {date, calls}, die ältesten zuerst, bis zum heutigen Datum in UTC. Ein Tag ohne Aufrufe erscheint mit 0. Jeder Tag zählt die Aufrufe des Kontos über alle seine Schlüssel, abzüglich gutgeschriebener Aufrufe. Ohne days bleibt die Antwort unverändert.

Felder der Nutzungsantwort
Feld	Beschreibung
tierstring	Der Tarif des Kontos: free, pro oder api.
periodstring	Der Kalendermonat, YYYY-MM (UTC).
resetAtstring	Wann das Kontingent zurückgesetzt wird: der erste Augenblick des nächsten Monats.
allowance, used, remaininginteger	Das Kontingent des Monats, die darauf angerechneten Aufrufe abzüglich der Gutschriften und der Rest.
overageobject	Nutzungsabhängige Mehrnutzung: ob das Konto berechtigt ist, ob sie eingeschaltet ist, ihre Nutzung und ihre Obergrenze.
keysarray	Jeder Schlüssel des Kontos: keyId, label, client, active, used, lastUsedAt.
rateLimitPerMinuteinteger	Das Limit pro Minute für die Zugangsdaten, die die Anfrage trug.
daily{date, calls}[]	Nur mit ?days=N: die Aufrufe jedes der letzten N Tage in UTC.

Nutzungs-Header

Jede gezählte Antwort (ein Rechneraufruf, ein Batch, ein mit Schlüssel eingereichter Job) trägt dieselben Zahlen in Headern, die ein Browser lesen kann:

Nutzungs-Header
Header	Bedeutung
X-Usage-Allowance	Das monatliche Kontingent des Kontos.
X-Usage-Used	In diesem Monat gezählte Aufrufe, einschließlich dieses.
X-Usage-Reset	Wann das Kontingent zurückgesetzt wird (ISO-8601, UTC): der erste Augenblick des nächsten Monats.
X-Usage-Overage	Nur vorhanden, wenn in diesem Monat nutzungsabhängige Mehrnutzung gezählt wurde: wie viele Aufrufe.

Anfragen pro Minute, pro Adresse

Das Limit pro Minute richtet sich nach den Zugangsdaten, die eine Anfrage trägt, nicht nach dem Tarif. Darüber antwortet die API mit 429 und einem Header Retry-After. Die Endpunkte der Gerätefreigabe unterliegen dem Limit ohne Zugangsdaten, gleich was sie mitführen.

Ratenlimits pro Minute
Die Anfrage trägt	Anfragen pro Minute
Keine Zugangsdaten	30
Angemeldete Sitzung	60
API-Schlüssel	120

Weitere Limits

Ein Batch enthält höchstens 50 Berechnungen; siehe Batch.
3 Simulationsjobs gleichzeitig in der Warteschlange oder in Ausführung, pro Aufrufer; siehe Simulationsjobs.

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

Ohne days derselbe Body ohne 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"
}

Bei einem gezählten Aufruf, sobald das Kontingent verbraucht ist, mit Retry-After in Sekunden bis resetAt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.