Abschnitte der Dokumentation

Batch

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

Bis zu 50 Berechnungen in einer Anfrage, beliebige Rechner gemischt: ein Parameter-Sweep oder die Werte eines Entwurfs zusammen. Jeder Eintrag wird genau so berechnet, wie /calculate ihn berechnet.

Der Batch-Endpunkt gehört zum Tarif API. Jeder berechnete Eintrag zählt als ein Aufruf; ein Eintrag, der vor der Berechnung abgelehnt wird, kostet nichts.

Request-Body

BatchRequest
Feld	Beschreibung
calculationserforderlicharray	1 bis 50 Einträge, jeder {slug, inputs}, wie /calculate sie annimmt. Mehr wird mit 400 und dem Limit abgelehnt.

Antwort

BatchResponse
Feld	Beschreibung
resultsarray	Ein Eintrag pro Berechnung, in Reihenfolge.
results[].slugstring	Der Rechner des Eintrags.
results[].values, warnings, errors, provenanceas /calculate	Ein berechneter Eintrag: genau das, was /calculate dafür zurückgibt.
results[].error, errorKindstring	Ein nicht berechneter Eintrag: warum (ein unbekannter Slug, eine Eingabe, die keine endliche Zahl ist). Er wurde nicht gezählt.

Die Ergebnisse stehen in der Reihenfolge der Anfrage. Prüfen Sie jeden Eintrag: Ein berechneter hat values und provenance; einer, der nicht berechnet wurde, hat error und errorKind. Ein Fehler in einem Eintrag lässt die anderen nie scheitern.

Ablehnungen

400: keine Berechnungen (At least one calculation is required) oder mehr als 50, mit dem Limit.
401: kein Schlüssel oder ein ungültiger Schlüssel.
402: Das Kontingent reicht nicht für die zu berechnenden Einträge; es wurde nichts gezählt.
403: Der Tarif des Kontos hat keinen Batch-Zugang; der Body nennt den Tarif, der ihn hat.

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

Der letzte Eintrag nennt keinen Rechner: allein abgelehnt und nicht gezählt.

{
  "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/"
}

Der Tarif des Kontos hat keinen Batch-Zugang.

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

Mehr als 50 Berechnungen.