Abschnitte der Dokumentation

Berechnen

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

Führt jeden der 255 Rechner mit den Eingaben aus, die Sie auf seiner Seite eintippen würden, in den Einheiten, die die Seite zeigt, und gibt jede Ausgabe, die Warnungen und die Provenienz als JSON zurück.

Authentifizieren Sie sich mit dem Header X-API-Key. Schlüssel beginnen mit rfc_ und werden im Dashboard erstellt. Jeder Aufruf wird auf das monatliche Kontingent des Kontos angerechnet: 5 im Tarif Free, 100 im Tarif Pro, 10.000 im Tarif API.

Request-Body

CalculateRequest
Feld	Beschreibung
slugerforderlichstring	Der Rechner, über den Slug in der Adresse seiner Seite, z. B. rf-link-budget. Jeder Slug ist unter „Slugs und Eingaben“ aufgeführt.
inputserforderlichobject of numbers	Eingabewerte unter den Eingabeschlüsseln des Rechners, in den Einheiten, die seine Referenz nennt. Senden Sie jede Eingabe: Die meisten sind erforderlich, und ein Aufruf, dem eine davon fehlt, wird abgelehnt (400); eine weggelassene optionale Eingabe erhält den Standardwert, den die Referenz zeigt. Ein Schlüssel, den der Rechner nicht liest, wird mit einer Warnung ignoriert.

Eingaben für rf-link-budget

Aus der Definition des Rechners erzeugt. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert. Die Eingaben jedes Rechners stehen unter Slugs und Eingaben.

Eingaben von rf-link-budget
Name	Einheit	Bereich	Standardwert	Beschreibung
txPowerZahl	dBm	−30 … 100	30	Ausgangsleistung des Senders
txGainZahl	dBi	−30 … 60	3	TX-Antennengewinn in dBi
txCableLossZahl	dB	0 … 20	1	TX-Kabel + Steckerverluste (positiver Wert)
frequencyZahl	MHz	0.1 … 1000000	2400	Mittenfrequenz
distanceZahl	km	0.001 … 1000000	1	Abstand zwischen TX und RX
rainFadeZahl	dB	0 … 50	0	Regendämpfung gemäß ITU-R P.838. Verwenden Sie 0 für Bodenverbindungen mit Sichtverbindung; 3—20 dB für Satellitenverbindungen über 10 GHz in Gebieten mit starkem Regen.
atmosphericLossZahl	dB	0 … 20	0.5	Gasabsorption (O₂ bei 60 GHz: ~15 dB/km; H₂O bei 22 GHz: ~0,2 dB/km). Verwenden Sie 0,5 dB, typisch für terrestrische Verbindungen unter 6 GHz.
pointingLossZahl	dB	0 … 10	0	Verlust der Fehlausrichtung der Antenne. Schalen mit Bleistiftstrahl: 0,5—3 dB. Rundstrahlantennen oder Breitstrahlantennen: 0 dB.
extraLossCountZahl	keine	0 … 4	0	Wie viele zusätzliche Verlustbedingungen sind im Budget enthalten, z. B. Polarisationsstörungen, Körperverlust oder Laub
extraLoss1Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss2Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss3Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss4Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
rxGainZahl	dBi	−30 … 60	3	RX-Antennengewinn in dBi
rxCableLossZahl	dB	0 … 20	1	RX-Kabel + Steckerverluste
rxSensitivityZahl	dBm	−160 … 0	-90	Minimaler empfangbarer Signalpegel
targetMarginZahl	dB	0 … 60	10	Der Fade-Rand, den die Verbindung einhalten muss, muss über der Empfindlichkeit des Empfängers liegen. Der Status wird an oder über diesem Wert weitergegeben und fällt unter 0 dB aus.

Antwort

CalculateResponse
Feld	Beschreibung
slugstring	Der Rechner, wie angefragt.
valuesobject of numbers	Jede Ausgabe unter ihrem Schlüssel, in den Einheiten, die ihre Referenz nennt. null, wo ein Wert unbegrenzt oder nicht definiert ist, etwa die Rückflussdämpfung bei perfekter Anpassung.
warningsstring[]	Die eigenen Warnungen des Rechners, dann die der API: eine nicht gelesene Eingabe, eine Eingabe außerhalb des Bereichs, für den der Rechner ausgelegt ist.
errorsstring[]	Die Fehler des Rechners; leer bei Erfolg.
provenanceobject	Wie die Werte berechnet wurden: Methode, Engine-Version, Formelquelle, Annahmen und gültiger Bereich. Siehe Provenienz.

Die Ausgaben von rf-link-budget, in values:

Ausgaben von rf-link-budget
Feld	Einheit	Beschreibung
fspl	dB	Verlust des freien Speicherplatzes
eirp	dBm	EIRP
rxPower	dBm	Empfangene Leistung
linkMarginHauptwert	dB	Link-Rand
maxRangeKm	km	Max. Reichweite
totalAdditionalLoss	dB	Zusätzlicher Gesamtverlust
maxRangeAtTarget	km	Reichweite am Zielrand
wavelength	mm	Wellenlänge
fresnelRadius	m	Radius der ersten Fresnel-Zone

Fehler

Fehler von POST /calculate
Status	Python-Ausnahme	Wann
400	ValidationError	Die Anfrage lässt sich so nicht beantworten: eine Eingabe, die keine endliche Zahl ist, eine Lösung, die sich nicht aufsetzen lässt, ein Job-Body außerhalb seines Vertrags oder ein Batch, der leer ist oder sein Limit überschreitet. Es wird nichts gezählt.
401	AuthError	Es wurde kein Schlüssel gesendet (der Body trägt keyUrl), oder der Schlüssel wurde nicht von uns ausgegeben oder wurde widerrufen. Betrifft nie das Kontingent.
402	QuotaError	Das monatliche Kontingent des Kontos ist verbraucht, auf jeder gezählten Route. Es wurde nichts gezählt. Retry-After gibt die Sekunden bis resetAt an.
404	NotFound	Kein solcher Rechner-Slug, Jobtyp oder Job. Es wird nichts gezählt.
422	ValidationError	Der Body lässt sich nicht lesen: Ein Pflichtfeld fehlt, oder ein Wert hat den falschen Typ (eine als Text gesendete Eingabe). Beantwortet, bevor die Route läuft.
429	RateLimitError	Zu viele Anfragen in einer Minute für diese Zugangsdaten oder zu viele Jobs gleichzeitig in der Warteschlange oder in Ausführung. Retry-After nennt, wann Sie es erneut versuchen können.
500	APIError	Das Ergebnis wurde berechnet, konnte aber nicht zurückgegeben werden, oder eine Lösung ist gescheitert. Es wurde nichts abgerechnet.
503	APIError	Der Schlüssel oder der Kontingentzähler ließ sich nicht prüfen, oder ein Job ließ sich nicht einreihen. Es wurde nichts eingereiht oder abgerechnet; versuchen Sie es erneut.

Jede Prüfung läuft, bevor etwas gezählt wird: der Schlüssel, der Rechner, dann die Eingaben. Siehe Fehler für jeden Body.

Ausprobieren

Senden Sie von dieser Seite aus eine Anfrage mit Ihrem eigenen Schlüssel. Sie zählt wie jeder andere Aufruf.

RechnerEingaben (JSON)API-Schlüssel

Eine Anfrage braucht einen Schlüssel und wird auf das Kontingent seines Kontos angerechnet. Kostenlosen Schlüssel holen.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "rf-link-budget",
    "inputs": {
      "txPower": 20,
      "txGain": 2,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 0.5,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 2,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "targetMargin": 10
    }
  }'

import rftools

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

result = client.calculate("rf-link-budget", {
    "txPower": 20,
    "txGain": 2,
    "txCableLoss": 1,
    "frequency": 2400,
    "distance": 0.5,
    "rainFade": 0,
    "atmosphericLoss": 0.5,
    "pointingLoss": 0,
    "extraLossCount": 0,
    "extraLoss1": 0,
    "extraLoss2": 0,
    "extraLoss3": 0,
    "extraLoss4": 0,
    "rxGain": 2,
    "rxCableLoss": 1,
    "rxSensitivity": -90,
    "targetMargin": 10,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "rf-link-budget",
    "inputs": {
      "txPower": 20,
      "txGain": 2,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 0.5,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 2,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "targetMargin": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "rf-link-budget",
	  "inputs": {
	    "txPower": 20,
	    "txGain": 2,
	    "txCableLoss": 1,
	    "frequency": 2400,
	    "distance": 0.5,
	    "rainFade": 0,
	    "atmosphericLoss": 0.5,
	    "pointingLoss": 0,
	    "extraLossCount": 0,
	    "extraLoss1": 0,
	    "extraLoss2": 0,
	    "extraLoss3": 0,
	    "extraLoss4": 0,
	    "rxGain": 2,
	    "rxCableLoss": 1,
	    "rxSensitivity": -90,
	    "targetMargin": 10
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", 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

{
  "slug": "rf-link-budget",
  "values": {
    "fspl": 94.03140814283587,
    "eirp": 21,
    "rxPower": -72.53140814283587,
    "linkMargin": 17.468591857164128,
    "maxRangeKm": 3.73593745752468,
    "totalAdditionalLoss": 0.5,
    "wavelength": 124.91352416666666,
    "fresnelRadius": 3.951479535671839,
    "maxRangeAtTarget": 1.181407156171655
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:rf-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Friis, \"A Note on a Simple Transmission Formula\" (1946)",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "txPower": {
          "min": -30,
          "max": 100,
          "unit": "dBm"
        },
        "txGain": {
          "min": -30,
          "max": 60,
          "unit": "dBi"
        },
        "txCableLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "frequency": {
          "min": 0.1,
          "max": 1000000,
          "unit": "MHz"
        },
        "distance": {
          "min": 0.001,
          "max": 1000000,
          "unit": "km"
        },
        "rainFade": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "atmosphericLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "pointingLoss": {
          "min": 0,
          "max": 10,
          "unit": "dB"
        },
        "extraLossCount": {
          "min": 0,
          "max": 4,
          "unit": ""
        },
        "extraLoss1": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss2": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss3": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss4": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "rxGain": {
          "min": -30,
          "max": 60,
          "unit": "dBi"
        },
        "rxCableLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "rxSensitivity": {
          "min": -160,
          "max": 0,
          "unit": "dBm"
        },
        "targetMargin": {
          "min": 0,
          "max": 60,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "txPower": 20,
      "txGain": 2,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 0.5,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 2,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "targetMargin": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": "Calculator 'rf-link-budgett' not found",
  "errorKind": "invalid_request"
}

Ein Slug, den es nicht gibt. Es wurde nichts gezählt.

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "txPower"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "20 dBm"
    }
  ]
}

Eine als Text gesendete Eingabe. Beantwortet, bevor die Route läuft; es wurde nichts gezählt.

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

Das Kontingent des Monats ist verbraucht, mit Retry-After.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteRF Link Budgetrechner, mit diesen Werten in der Adresse