Sections de la documentation

Quotas et limites

Deux limites s'appliquent : un quota mensuel d'appels, qui appartient au compte, et un nombre de requêtes par minute, qui dépend de l'identifiant que porte la requête. Consulter ce qui reste n'est jamais décompté.

Quota mensuel, par compte

Le quota appartient au compte, pas à une clé : les appels de toutes ses clés sont décomptés d'un seul chiffre. Il est réinitialisé au début de chaque mois civil en UTC. Un appel refusé (une clé absente ou non valide, un calculateur inconnu, un corps illisible) ne coûte rien, et un appel qui échoue du fait du service après avoir été décompté est restitué.

Quota mensuel par offre
Offre	Appels par mois	Clés	Point de terminaison par lots
Free	5	1 clé d'API	Non
Pro · $9 par mois	100	3 clés d'API	Non
API · $19 par mois	10 000	5 clés d'API	Oui, jusqu'à 50 par requête

Un quota épuisé, c'est 402, jamais 401 ni 429 ; voir Erreurs.

Usage

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

GET /api/py/v1/usage indique à une clé ou à une session connectée ce que le compte a consommé ce mois-ci et ce qui reste, l'état du dépassement et les appels attribués à chacune de ses clés. Sa consultation n'est jamais décomptée : un programme peut afficher ses appels restants aussi souvent qu'il le souhaite, dans la limite par minute.

La série quotidienne

Ajoutez ?days=N, un entier de 1 à 90, et la réponse contient daily : exactement N entrées {date, calls}, de la plus ancienne à la plus récente, jusqu'à la date du jour en UTC. Un jour sans appel figure avec 0. Chaque jour compte les appels du compte sur toutes ses clés, déduction faite des appels restitués. Sans days, la réponse est inchangée.

Champs de la réponse d'usage
Champ	Description
tierstring	L'offre du compte : free, pro ou api.
periodstring	Le mois civil, YYYY-MM (UTC).
resetAtstring	Le moment où le quota est réinitialisé : le premier instant du mois suivant.
allowance, used, remaininginteger	Le quota du mois, les appels décomptés déduction faite des restitutions, et ce qui reste.
overageobject	Dépassement payé à l'usage : si le compte y a droit, s'il est activé, son usage et son plafond.
keysarray	Chaque clé du compte : keyId, label, client, active, used, lastUsedAt.
rateLimitPerMinuteinteger	La limite par minute de l'identifiant que portait la requête.
daily{date, calls}[]	Seulement avec ?days=N : les appels de chacun des N derniers jours en UTC.

En-têtes d'usage

Chaque réponse décomptée (un appel à un calculateur, un lot, une tâche soumise avec une clé) porte les mêmes chiffres dans des en-têtes qu'un navigateur peut lire :

En-têtes d'usage
En-tête	Signification
X-Usage-Allowance	Le quota mensuel du compte.
X-Usage-Used	Les appels décomptés ce mois-ci, celui-ci compris.
X-Usage-Reset	Le moment où le quota est réinitialisé (ISO-8601, UTC) : le premier instant du mois suivant.
X-Usage-Overage	Présent seulement si un dépassement payé à l'usage a été décompté ce mois-ci : combien d'appels.

Requêtes par minute, par adresse

La limite par minute dépend de l'identifiant que porte une requête, pas de l'offre. Au-delà, l'API répond 429 avec un en-tête Retry-After. Les points de terminaison de l'autorisation d'appareil sont soumis à la limite sans identifiant, quoi qu'ils portent.

Limites de débit par minute
La requête porte	Requêtes par minute
Aucun identifiant	30
Session connectée	60
Clé d'API	120

Autres limites

Un lot contient au plus 50 calculs ; voir Calcul par lots.
3 tâches de simulation en file d'attente ou en cours à la fois, par appelant ; voir Tâches de simulation.

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

Sans days, le même corps sans 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"
}

Sur un appel décompté une fois le quota épuisé, avec Retry-After en secondes jusqu'à resetAt.

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

Trop de requêtes en une minute, avec Retry-After.