문서 섹션

계산

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

계산기 255개 중 어느 것이든, 그 페이지에 입력하는 값으로, 페이지에 표시된 단위로 실행하고, 모든 출력과 경고, 출처 정보를 JSON으로 반환합니다.

X-API-Key 헤더로 인증합니다. 키는 rfc_로 시작하며 대시보드에서 만듭니다. 모든 호출은 계정의 월간 할당량에서 차감됩니다: Free 요금제 5회, Pro 요금제 100회, API 요금제 10,000회.

요청 본문

CalculateRequest
필드	설명
slug필수string	계산기. 페이지 주소에 있는 슬러그로 지정합니다(예: rf-link-budget). 모든 슬러그는 '슬러그와 입력'에 나와 있습니다.
inputs필수object of numbers	입력값. 계산기의 입력 키별로, 레퍼런스에 나온 단위로 지정합니다. 모든 입력을 보내세요. 대부분 필수이며, 하나라도 빠진 호출은 거부됩니다(400). 생략한 선택 입력은 레퍼런스에 표시된 기본값을 사용합니다. 계산기가 읽지 않는 키는 경고와 함께 무시됩니다.

rf-link-budget의 입력

계산기의 정의에서 생성했습니다. 범위 밖의 입력도 계산되며 출처 정보에 표시됩니다. 모든 계산기의 입력은 슬러그와 입력에 있습니다.

rf-link-budget의 입력
이름	단위	범위	기본값	설명
txPower숫자	dBm	−30 … 100	30	송신기 출력 전력
txGain숫자	dBi	−30 … 60	3	TX 안테나 게인 (dBi)
txCableLoss숫자	dB	0 … 20	1	TX 케이블+커넥터 손실 (양수 값)
frequency숫자	MHz	0.1 … 1000000	2400	중심 주파수
distance숫자	km	0.001 … 1000000	1	텍사스와 RX 간의 거리
rainFade숫자	dB	0 … 50	0	ITU-R P.838에 따른 빗물 감쇠폭우 지역에서 가시선 지상 링크에는 0을 사용하고, 10GHz 이상의 위성 링크에는 3—20dB를 사용하십시오.
atmosphericLoss숫자	dB	0 … 20	0.5	기체 흡수율 (60GHz에서의 O₂: ~15dB/km, 22GHz에서의 H₂O: ~0.2dB/km)6GHz 미만의 지상파 링크에는 일반적으로 0.5dB를 사용하십시오.
pointingLoss숫자	dB	0 … 10	0	안테나 정렬 불량.펜슬 빔 디쉬: 0.5—3 dB.전방향 또는 와이드 빔 안테나: 0dB.
extraLossCount숫자	없음	0 … 4	0	편광 불일치, 신체 손실 또는 잎사귀와 같은 추가 손실 조건이 예산에 포함되는 횟수
extraLoss1숫자	dB	0 … 50	0	편광 불일치, 신체 손실, 나뭇잎 또는 벽과 같은 경로의 추가 손실
extraLoss2숫자	dB	0 … 50	0	편광 불일치, 신체 손실, 나뭇잎 또는 벽과 같은 경로의 추가 손실
extraLoss3숫자	dB	0 … 50	0	편광 불일치, 신체 손실, 나뭇잎 또는 벽과 같은 경로의 추가 손실
extraLoss4숫자	dB	0 … 50	0	편광 불일치, 신체 손실, 나뭇잎 또는 벽과 같은 경로의 추가 손실
rxGain숫자	dBi	−30 … 60	3	RX 안테나 게인 (dBi)
rxCableLoss숫자	dB	0 … 20	1	RX 케이블 + 커넥터 손실
rxSensitivity숫자	dBm	−160 … 0	-90	수신 가능한 최소 신호 레벨
targetMargin숫자	dB	0 … 60	10	링크의 페이드 마진은 수신기 감도보다 높게 유지해야 합니다.상태는 그 이상으로 전달되고 0dB 미만에서는 실패합니다.

응답

CalculateResponse
필드	설명
slugstring	요청한 계산기.
valuesobject of numbers	각 출력을 키별로, 레퍼런스에 나온 단위로 반환합니다. 값에 상한이 없거나 정의되지 않는 경우(완벽한 정합에서의 반사 손실 등)는 null입니다.
warningsstring[]	계산기 자체의 경고, 그다음 API의 경고: 읽지 않은 입력, 계산기의 적용 범위 밖에 있는 입력.
errorsstring[]	계산기의 오류. 성공하면 비어 있습니다.
provenanceobject	값의 계산 방법: 방법, 엔진 버전, 수식 출처, 가정, 유효 범위. '출처 정보'를 참고하세요.

rf-link-budget의 출력(values 안):

rf-link-budget의 출력
필드	단위	설명
fspl	dB	자유 공간 경로 손실
eirp	dBm	EIRP
rxPower	dBm	받은 전력
linkMargin주요 값	dB	링크 마진
maxRangeKm	km	최대 범위
totalAdditionalLoss	dB	총 추가 손실
maxRangeAtTarget	km	목표 마진에서의 범위
wavelength	mm	파장
fresnelRadius	m	첫 번째 프레넬 영역 반경

오류

POST /calculate의 오류
상태	Python 예외	발생 조건
400	ValidationError	보낸 그대로는 요청에 답할 수 없습니다: 유한한 숫자가 아닌 입력, 설정할 수 없는 역산, 계약을 벗어난 작업 본문, 비어 있거나 한도를 넘는 배치. 집계되지 않습니다.
401	AuthError	키를 보내지 않았거나(본문에 keyUrl이 담깁니다), 저희가 발급하지 않았거나 폐기된 키입니다. 할당량과는 관계가 없습니다.
402	QuotaError	집계되는 모든 경로에서 계정의 월간 할당량을 다 썼습니다. 집계되지 않았습니다. Retry-After에 resetAt까지 남은 초가 담깁니다.
404	NotFound	그런 계산기 슬러그, 작업 유형, 작업이 없습니다. 집계되지 않습니다.
422	ValidationError	본문을 해석할 수 없습니다: 필수 필드가 없거나, 값의 타입이 잘못되었습니다(텍스트로 보낸 입력 등). 경로가 실행되기 전에 응답합니다.
429	RateLimitError	그 자격 증명으로 1분 동안 요청이 너무 많거나, 대기 중이거나 실행 중인 작업이 동시에 너무 많습니다. Retry-After에 다시 시도할 시점이 담깁니다.
500	APIError	결과는 계산되었지만 반환하지 못했거나, 역산에 실패했습니다. 과금되지 않았습니다.
503	APIError	키나 할당량 카운터를 확인하지 못했거나, 작업을 대기열에 넣지 못했습니다. 대기열에 들어가지도 과금되지도 않았습니다. 다시 시도하세요.

키, 계산기, 입력 순으로 모든 검사가 끝나기 전에는 집계되지 않습니다. 각 본문은 오류를 참고하세요.

직접 해 보기

자신의 키로 이 페이지에서 요청을 보내 보세요. 다른 호출과 똑같이 집계됩니다.

계산기입력(JSON)API 키

요청에는 키가 필요하며, 해당 계정의 할당량에서 차감됩니다. 무료 키 받기.

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

존재하지 않는 슬러그입니다. 집계되지 않았습니다.

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

텍스트로 보낸 입력입니다. 경로가 실행되기 전에 응답하며, 집계되지 않았습니다.

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

그 달의 할당량을 다 썼습니다. 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/"
}

1분 동안 요청이 너무 많습니다. Retry-After가 함께 옵니다.

같은 입력으로 계산기 페이지 열기RF 링크 버짓 계산기, 이 값이 주소에 담긴 상태로