Secciones de la documentación

Cuotas y límites

Se aplican dos límites: una cuota mensual de llamadas, que pertenece a la cuenta, y un número de solicitudes por minuto, que depende de la credencial que lleva la solicitud. Consultar lo que queda nunca se cuenta.

Cuota mensual, por cuenta

La cuota pertenece a la cuenta, no a una clave: las llamadas de todas sus claves se descuentan de una única cifra. Se restablece al inicio de cada mes natural en UTC. Una llamada rechazada (una clave ausente o no válida, una calculadora desconocida, un cuerpo que no se puede leer) no cuesta nada, y una llamada en la que el servicio falla después de contarla se devuelve.

Cuota mensual por plan
Plan	Llamadas al mes	Claves	Endpoint por lotes
Free	5	1 clave de API	No
Pro · $9 al mes	100	3 claves de API	No
API · $19 al mes	10.000	5 claves de API	Sí, hasta 50 por solicitud

Una cuota agotada es 402, nunca 401 ni 429; consulte Errores.

Uso

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

GET /api/py/v1/usage responde a una clave o a una sesión iniciada con lo que la cuenta ha usado este mes y lo que le queda, el estado del excedente y las llamadas atribuidas a cada una de sus claves. Consultarlo nunca se cuenta, así que un programa puede mostrar sus llamadas restantes tantas veces como quiera, dentro del límite por minuto.

La serie diaria

Añada ?days=N, un número entero de 1 a 90, y la respuesta incluye daily: exactamente N entradas {date, calls}, de la más antigua a la más reciente, terminando en la fecha de hoy en UTC. Un día sin llamadas aparece con 0. Cada día suma las llamadas de la cuenta en todas sus claves, descontadas las devueltas. Sin days, la respuesta no cambia.

Campos de la respuesta de uso
Campo	Descripción
tierstring	El plan de la cuenta: free, pro o api.
periodstring	El mes natural, YYYY-MM (UTC).
resetAtstring	Cuándo se restablece la cuota: el primer instante del mes siguiente.
allowance, used, remaininginteger	La cuota del mes, las llamadas que se le han descontado (netas de devoluciones) y lo que queda.
overageobject	Excedente de pago por uso: si la cuenta puede usarlo, si está activado, y su uso y su tope.
keysarray	Cada clave de la cuenta: keyId, label, client, active, used, lastUsedAt.
rateLimitPerMinuteinteger	El límite por minuto de la credencial que llevaba la solicitud.
daily{date, calls}[]	Solo con ?days=N: las llamadas de cada uno de los últimos N días en UTC.

Cabeceras de uso

Cada respuesta contabilizada (una llamada a una calculadora, un lote, un trabajo enviado con una clave) lleva las mismas cifras en cabeceras que un navegador puede leer:

Cabeceras de uso
Cabecera	Significado
X-Usage-Allowance	La cuota mensual de la cuenta.
X-Usage-Used	Llamadas contadas este mes, incluida esta.
X-Usage-Reset	Cuándo se restablece la cuota (ISO-8601, UTC): el primer instante del mes siguiente.
X-Usage-Overage	Solo presente cuando este mes se contó excedente de pago por uso: cuántas llamadas.

Solicitudes por minuto, por dirección

El límite por minuto depende de la credencial que lleva una solicitud, no del plan. Por encima de él, la API responde 429 con una cabecera Retry-After. Los endpoints de la autorización de dispositivo se someten al límite sin credencial, lleven lo que lleven.

Límites de frecuencia por minuto
La solicitud lleva	Solicitudes por minuto
Ninguna credencial	30
Sesión iniciada	60
Clave de API	120

Otros límites

Un lote incluye como máximo 50 cálculos; consulte Cálculo por lotes.
3 trabajos de simulación en cola o en ejecución a la vez, por cliente; consulte Trabajos de simulación.

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

Sin days, el mismo cuerpo sin 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"
}

En una llamada contabilizada una vez agotada la cuota, con Retry-After en segundos hasta resetAt.

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

Demasiadas solicitudes en un minuto, con Retry-After.