문서 섹션

배치

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

요청 하나에 최대 50건의 계산을, 계산기를 자유롭게 섞어 담을 수 있습니다. 매개변수 스윕이나 한 설계의 수치를 한꺼번에 구할 때 씁니다. 각 항목은 /calculate가 계산하는 것과 똑같이 계산됩니다.

배치 엔드포인트는 API 요금제에 포함됩니다. 계산한 항목마다 호출 1회로 집계되며, 계산 전에 거부된 항목은 비용이 들지 않습니다.

요청 본문

BatchRequest
필드	설명
calculations필수array	1~50개 항목. 각 항목은 /calculate가 받는 것과 같은 {slug, inputs}입니다. 이를 넘으면 한도와 함께 400으로 거부됩니다.

응답

BatchResponse
필드	설명
resultsarray	계산마다 항목 하나씩, 순서대로.
results[].slugstring	그 항목의 계산기.
results[].values, warnings, errors, provenanceas /calculate	계산된 항목: /calculate가 그 항목에 대해 반환하는 것과 정확히 같습니다.
results[].error, errorKindstring	계산되지 않은 항목: 그 이유(알 수 없는 슬러그, 유한한 숫자가 아닌 입력). 집계되지 않았습니다.

결과는 요청과 같은 순서로 나옵니다. 각 항목을 확인하세요. 계산된 항목에는 values와 provenance가 있고, 계산되지 않은 항목에는 error와 errorKind가 있습니다. 한 항목의 실패가 다른 항목을 실패시키지는 않습니다.

거부

400: 계산이 없거나(At least one calculation is required) 50건을 넘는 경우이며, 한도가 함께 표시됩니다.
401: 키가 없거나 유효하지 않은 키.
402: 계산할 항목만큼의 할당량이 남아 있지 않음. 집계되지 않았습니다.
403: 계정의 요금제에 배치 이용이 포함되어 있지 않음. 본문에 배치를 포함하는 요금제가 표시됩니다.

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

마지막 항목에는 계산기가 지정되지 않았습니다. 그 항목만 거부되고 집계되지 않습니다.

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

계정의 요금제에 배치 이용이 포함되어 있지 않습니다.

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

계산이 50건을 넘습니다.