Seções da documentação

Lote

POSThttps://rftools.io/api/py/v1/calculate/batch

Até 50 cálculos em uma requisição, com qualquer combinação de calculadoras: uma varredura de parâmetros ou os números de um projeto juntos. Cada item é calculado exatamente como /calculate o calcula.

O endpoint em lote faz parte do plano API. Cada item calculado conta como uma chamada; um item recusado antes de ser calculado não custa nada.

Corpo da requisição

BatchRequest
Campo	Descrição
calculationsobrigatórioarray	De 1 a 50 itens, cada um {slug, inputs} como /calculate os recebe. Mais que isso é recusado com 400 e o limite.

Resposta

BatchResponse
Campo	Descrição
resultsarray	Um item por cálculo, em ordem.
results[].slugstring	A calculadora do item.
results[].values, warnings, errors, provenanceas /calculate	Um item calculado: exatamente o que /calculate devolve para ele.
results[].error, errorKindstring	Um item que não foi calculado: o motivo (um slug desconhecido, uma entrada que não é um número finito). Ele não foi contabilizado.

Os resultados seguem a ordem da requisição. Verifique cada item: um item calculado tem values e provenance; um que não foi tem error e errorKind. A falha de um item nunca faz os outros falharem.

Recusas

400: nenhum cálculo (At least one calculation is required), ou mais de 50, com o limite.
401: nenhuma chave, ou uma chave inválida.
402: a cota não cobre os itens a calcular; nada foi contabilizado.
403: o plano da conta não tem acesso a lotes; o corpo nomeia o plano que tem.

curl -X POST https://rftools.io/api/py/v1/calculate/batch \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "calculations": [
      {
        "slug": "vswr-return-loss",
        "inputs": {
          "vswr": 1.5
        }
      },
      {
        "slug": "vswr-return-loss",
        "inputs": {
          "vswr": 2
        }
      },
      {
        "slug": "free-space-path-loss",
        "inputs": {
          "frequency": 2400,
          "distance": 0.05
        }
      },
      {
        "slug": "vswr-calculator",
        "inputs": {
          "vswr": 2
        }
      }
    ]
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

results = client.batch([
    ("vswr-return-loss", {"vswr": 1.5}),
    ("vswr-return-loss", {"vswr": 2}),
    ("free-space-path-loss", {"frequency": 2400, "distance": 0.05}),
    ("vswr-calculator", {"vswr": 2}),
])
for r in results:
    print(r.values if r.ok else r.error)

const response = await fetch("https://rftools.io/api/py/v1/calculate/batch", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "calculations": [
      {
        "slug": "vswr-return-loss",
        "inputs": {
          "vswr": 1.5
        }
      },
      {
        "slug": "vswr-return-loss",
        "inputs": {
          "vswr": 2
        }
      },
      {
        "slug": "free-space-path-loss",
        "inputs": {
          "frequency": 2400,
          "distance": 0.05
        }
      },
      {
        "slug": "vswr-calculator",
        "inputs": {
          "vswr": 2
        }
      }
    ]
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "calculations": [
	    {
	      "slug": "vswr-return-loss",
	      "inputs": {
	        "vswr": 1.5
	      }
	    },
	    {
	      "slug": "vswr-return-loss",
	      "inputs": {
	        "vswr": 2
	      }
	    },
	    {
	      "slug": "free-space-path-loss",
	      "inputs": {
	        "frequency": 2400,
	        "distance": 0.05
	      }
	    },
	    {
	      "slug": "vswr-calculator",
	      "inputs": {
	        "vswr": 2
	      }
	    }
	  ]
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate/batch", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	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

{
  "results": [
    {
      "slug": "vswr-return-loss",
      "values": {
        "gamma": 0.2,
        "returnLoss": 13.979400086720375,
        "mismatchLoss": 0.17728766960431602,
        "reflectedPct": 4.000000000000001,
        "transmittedPct": 96
      },
      "warnings": [],
      "errors": [],
      "provenance": {
        "method": "calculator:vswr-return-loss",
        "version": "api@3f2c1a9b04de",
        "formulaRef": "Pozar, \"Microwave Engineering\" 4th ed., Chapter 2",
        "assumptions": [],
        "validRange": {
          "status": "inside",
          "bounds": {
            "vswr": {
              "min": 1,
              "max": 100,
              "unit": ":1"
            }
          },
          "outside": [],
          "model": null
        },
        "computedAt": "2026-09-24T14:05:11.002Z",
        "inputs": {
          "vswr": 1.5
        },
        "seed": null,
        "elapsedSeconds": 0.002
      }
    },
    {
      "slug": "vswr-return-loss",
      "values": {
        "gamma": 0.3333333333333333,
        "returnLoss": 9.54242509439325,
        "mismatchLoss": 0.5115252244738131,
        "reflectedPct": 11.11111111111111,
        "transmittedPct": 88.88888888888889
      },
      "warnings": [],
      "errors": [],
      "provenance": {
        "method": "calculator:vswr-return-loss",
        "version": "api@3f2c1a9b04de",
        "formulaRef": "Pozar, \"Microwave Engineering\" 4th ed., Chapter 2",
        "assumptions": [],
        "validRange": {
          "status": "inside",
          "bounds": {
            "vswr": {
              "min": 1,
              "max": 100,
              "unit": ":1"
            }
          },
          "outside": [],
          "model": null
        },
        "computedAt": "2026-09-24T14:05:11.003Z",
        "inputs": {
          "vswr": 2
        },
        "seed": null,
        "elapsedSeconds": 0.003
      }
    },
    {
      "slug": "free-space-path-loss",
      "values": {
        "fspl_dB": 74.03140814283587,
        "fspl_linear": 25301182.210788365
      },
      "warnings": [],
      "errors": [],
      "provenance": {
        "method": "calculator:free-space-path-loss",
        "version": "api@3f2c1a9b04de",
        "formulaRef": "ITU-R P.525-4, Calculation of free-space attenuation",
        "assumptions": [],
        "validRange": {
          "status": "inside",
          "bounds": {
            "frequency": {
              "min": 0.1,
              "max": null,
              "unit": "MHz"
            },
            "distance": {
              "min": 0.001,
              "max": null,
              "unit": "km"
            }
          },
          "outside": [],
          "model": null
        },
        "computedAt": "2026-09-24T14:05:11.004Z",
        "inputs": {
          "frequency": 2400,
          "distance": 0.05
        },
        "seed": null,
        "elapsedSeconds": 0.004
      }
    },
    {
      "slug": "vswr-calculator",
      "error": "Calculator 'vswr-calculator' not found",
      "errorKind": "invalid_request"
    }
  ]
}

O último item não nomeia nenhuma calculadora: é recusado sozinho e não é contabilizado.

{
  "detail": "The batch endpoint is part of the API plan. This key's account is on the Free plan.",
  "errorKind": "not_available",
  "tier": "free",
  "requiredTier": "api",
  "upgradeUrl": "https://rftools.io/pricing/"
}

O plano da conta não tem acesso a lotes.

{
  "detail": "Batch limit is 50 calculations per request",
  "errorKind": "invalid_request",
  "limit": 50
}

Mais de 50 cálculos.