문서 섹션

API 문서

RF 및 전자 계산기 255개와 시뮬레이션 도구 13개를 REST로 스크립트, 노트북, 애플리케이션에 통합하세요. 엔드포인트 하나로 어떤 계산기든 실행할 수 있고, 시뮬레이터는 제출하고 폴링하는 작업으로 실행됩니다. 모든 결과에는 계산 방법이 함께 표시됩니다.

기본 URL은 https://rftools.io/api/py/v1입니다. 키는 X-API-Key 헤더로 보냅니다. 무료 키로 월 5회 호출할 수 있습니다. 대시보드에서 받으세요.

첫 번째 요청

계산기의 슬러그와 입력을 /calculate에 POST로 보냅니다. 응답에는 모든 출력이 이름별로 경고와 함께 담기며, 수식과 엔진 버전, 그리고 입력이 계산기의 적용 범위 안에 있었는지를 알려 주는 출처 정보 객체가 붙습니다. 이 설명 옆의 코드는 네 가지 언어로 쓴 호출과, 그 호출에 대해 API가 반환하는 응답입니다.

엔드포인트

공개된 모든 엔드포인트
엔드포인트	하는 일	집계
POST /api/py/v1/calculate	계산기 하나를 그 입력으로 실행합니다.	호출 1회
POST /api/py/v1/calculate/batch	요청 하나로 최대 50건의 계산을 실행합니다.	계산한 항목마다 1회
POST /api/py/v1/calculate/solve	출력을 목표값으로 만드는 입력값을 찾아, 그 값에서의 순방향 결과와 함께 반환합니다.	호출 1회
GET /api/py/v1/usage	그 달의 할당량과 사용량, 남은 양을 키별로 반환합니다. ?days=N을 붙이면 최근 N일 각각의 호출 수가 추가됩니다.	집계되지 않음
GET /api/py/v1/jobs/types	모든 시뮬레이션 작업 유형과 각각의 요금제, 시간 상한, 제한, 업로드.	집계되지 않음
GET /api/py/v1/jobs/types/{job_type}	작업 유형 하나의 매개변수 계약(JSON Schema).	집계되지 않음
POST /api/py/v1/jobs/estimate	작업을 제출하지 않고, 비용과 실행 시간을 견적 냅니다.	집계되지 않음
POST /api/py/v1/upload	작업 입력 파일용 서명된 양식.	집계되지 않음
POST /api/py/v1/jobs	시뮬레이션 작업을 제출합니다.	키 사용 시 호출 1회
GET /api/py/v1/jobs/{job_id}	작업의 상태와 진행률, 완료되면 결과 링크.	집계되지 않음
GET /api/py/v1/jobs	계정의 모든 키로 제출한, 호출자의 최근 작업.	집계되지 않음
POST /api/py/v1/apikeys	로그인한 계정의 키를 만듭니다.	집계되지 않음
POST /api/py/v1/oauth/device/code	디바이스 권한 부여를 시작합니다: 사용자가 승인할 코드를 발급합니다.	집계되지 않음
POST /api/py/v1/oauth/device/token	사용자가 코드를 승인하면 키를 받아 옵니다.	집계되지 않음
GET /api/py/health	서비스 상태.	집계되지 않음

시뮬레이션 작업 유형

시뮬레이터 13개가 비동기 작업으로 실행됩니다. 제출하고, 폴링하고, 결과를 읽습니다. 작업 유형마다 매개변수 계약을 공개합니다. 시뮬레이션 작업을 참고하세요.

시뮬레이션 작업 유형
jobType	시뮬레이터
antenna_sim	와이어 안테나 시뮬레이터 (NEC-2)
emi_radiated	EMI 방사 방출 추정기
eye_diagram	S-파라미터를 이용한 아이 다이어그램
fdtd_sparam	FDTD 송전선 시뮬레이터
filter_monte_carlo	RF 필터 몬테카를로 분석
impedance_match	광대역 임피던스 매칭 신시사이저
magnetics_optimizer	마그네틱 및 트랜스포머 설계 옵티마이저
pdn_impedance	PDN 임피던스 분석기 및 디커플링 커패시터 옵티마이저
radar_detection	레이더 탐지 성능 몬테카를로
rf_cascade	RF 캐스케이드 버짓 분석기
sat_link_budget	위성 및 지상파 링크 예산
smps_control_loop	SMPS 제어 루프 안정성 분석기
sparam_pipeline	S-파라미터 분석 파이프라인

다음으로 볼 페이지

빠른 시작1분 만에 키를 받고 첫 호출까지.인증키, 키 링크, 디바이스 권한 부여.계산요청, 응답, 거부.슬러그와 입력모든 계산기의 입력, 출력과 예제.Python 라이브러리pip install rftools-io: 타입이 지정된 호출과 CLI.MCP 서버같은 계산기와 시뮬레이션을 AI 에이전트에서.

기계가 읽을 수 있는 레퍼런스

통합할 준비가 되셨나요?

키를 받으면 1분 안에 요청을 보낼 수 있습니다. API 요금제는 월 10,000회, 키 사용 시 분당 120회 요청, 계산기 255개 전부를 제공합니다.

API 이용하기, 월 $19 키 관리 무료 API 키 받기

또는 대시보드에서 무료 키(월 5회)를 받으세요. 신용카드는 필요 없습니다.

첫 번째 요청

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "vswr-return-loss",
    "inputs": {
      "vswr": 2
    }
  }'

import rftools

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

result = client.calculate("vswr-return-loss", {"vswr": 2})
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": "vswr-return-loss",
    "inputs": {
      "vswr": 2
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "vswr-return-loss",
	  "inputs": {
	    "vswr": 2
	  }
	}`)
	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))
}

200application/json

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