Seções da documentação

Cotas e limites

Valem dois limites: uma cota mensal de chamadas, que pertence à conta, e um número de requisições por minuto, que depende da credencial que a requisição leva. Consultar o que resta nunca é contabilizado.

Cota mensal, por conta

A cota pertence à conta, não a uma chave: as chamadas de todas as chaves contam para um único total. Ela é zerada no início de cada mês do calendário em UTC. Uma chamada recusada (uma chave ausente ou inválida, uma calculadora desconhecida, um corpo que não pode ser lido) não custa nada, e uma chamada em que o serviço falha depois de contabilizá-la é devolvida.

Cota mensal por plano
Plano	Chamadas por mês	Chaves	Endpoint em lote
Free	5	1 chave de API	Não
Pro · $9 por mês	100	3 chaves de API	Não
API · $19 por mês	10.000	5 chaves de API	Sim, até 50 por requisição

Uma cota esgotada é 402, nunca 401 ou 429; veja Erros.

Uso

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

GET /api/py/v1/usage responde a uma chave ou a uma sessão conectada com o que a conta usou neste mês e o que resta, o estado do excedente e as chamadas atribuídas a cada uma das suas chaves. Consultá-lo nunca é contabilizado, então um programa pode mostrar as chamadas restantes quantas vezes quiser, dentro do limite por minuto.

A série diária

Adicione ?days=N, um número inteiro de 1 a 90, e a resposta ganha daily: exatamente N entradas {date, calls}, da mais antiga para a mais recente, terminando na data de hoje em UTC. Um dia sem chamadas aparece com 0. Cada dia soma as chamadas da conta em todas as suas chaves, descontadas as chamadas devolvidas. Sem days, a resposta não muda.

Campos da resposta de uso
Campo	Descrição
tierstring	O plano da conta: free, pro ou api.
periodstring	O mês do calendário, YYYY-MM (UTC).
resetAtstring	Quando a cota é zerada: o primeiro instante do próximo mês.
allowance, used, remaininginteger	A cota do mês, as chamadas contabilizadas nela descontadas as devoluções, e o que resta.
overageobject	Excedente com pagamento por uso: se a conta tem direito, se está ativado, e o seu uso e o seu teto.
keysarray	Cada chave da conta: keyId, label, client, active, used, lastUsedAt.
rateLimitPerMinuteinteger	O limite por minuto da credencial que a requisição levava.
daily{date, calls}[]	Só com ?days=N: as chamadas de cada um dos últimos N dias em UTC.

Cabeçalhos de uso

Toda resposta contabilizada (uma chamada a uma calculadora, um lote, um trabalho enviado com uma chave) traz os mesmos números em cabeçalhos que um navegador consegue ler:

Cabeçalhos de uso
Cabeçalho	Significado
X-Usage-Allowance	A cota mensal da conta.
X-Usage-Used	Chamadas contabilizadas neste mês, incluindo esta.
X-Usage-Reset	Quando a cota é zerada (ISO-8601, UTC): o primeiro instante do próximo mês.
X-Usage-Overage	Presente apenas quando houve excedente com pagamento por uso contabilizado neste mês: quantas chamadas.

Requisições por minuto, por endereço

O limite por minuto depende da credencial que a requisição leva, não do plano. Acima dele, a API responde 429 com um cabeçalho Retry-After. Os endpoints da autorização de dispositivo seguem o limite sem credencial, não importa o que levem.

Limites de taxa por minuto
A requisição leva	Requisições por minuto
Nenhuma credencial	30
Sessão conectada	60
Chave de API	120

Outros limites

Um lote leva no máximo 50 cálculos; veja Lote.
3 trabalhos de simulação na fila ou em execução ao mesmo tempo, por chamador; veja Trabalhos de simulação.

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

Sem days, o mesmo corpo sem 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"
}

Em uma chamada contabilizada depois que a cota se esgota, com Retry-After em segundos até resetAt.

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

Requisições demais em um minuto, com Retry-After.