ドキュメントのセクション

BGA ランドパッド計算ツール

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

スラッグ bga-land-pad。IPC-7351Bの密度レベルに基づいて、BGAランドパッドの直径、ソルダーマスクの開口部、およびエスケープルーティングを計算します。

入力

これらの入力を、表示されている単位ですべて inputs に入れて送ってください。ほとんどは必須で、1 つでも欠けた呼び出しは拒否され（400）、費用はかかりません。省略しても計算できる入力は、表示されている既定値を使います。範囲外の入力も計算され、来歴で示されます。

bga-land-pad の入力
名前	単位	範囲	既定値	説明
ballPitch数値	mm	0.3 … 1.27	1	ボールピッチ
ballDiameter数値	mm	0.15 … 0.89	0.6	ボールの直径
solderMaskDefined数値	なし	0 … 1	0	ソルダーマスクの定義次のいずれか：0 いいえ (NSMD) · 1 はい (SMD)
viaInPad数値	なし	0 … 1	0	ビア・イン・パッド次のいずれか：0 いいえ · 1 はい
ballType数値	なし	0 … 1	0	コラプス型ボール（大半の BGA）にはボールより小さいランド、非コラプス型ボールにはボールより大きいランドを使います次のいずれか：0 コラプス型 · 1 非コラプス型
landDiameter数値	mm	0.05 … 1.5	0.48	基板上のランド径。ボールに対する IPC-7351B のランドと照合します

廃止済み（引き続き受け付けますが、警告付きで無視されます）： densityLevel (Density Level (0=Most, 1=Nominal, 2=Least), 2026年10月6日).

出力

values に名前ごとに返されます。上限がない値や定義されない値は null です。

bga-land-pad の出力
フィールド	単位	説明
padDia主要値	mm	パッド直径
maskOpening	mm	ソルダーマスク開口部
maxViaDrill	mm	最大ビアドリル径（ビア・イン・パッド）
channelWidth	mm	チャネル幅
escapeRoutes	なし	チャネルあたりのエスケープ配線数
maxTraceWidth	mm	チャネル内の最大トレース幅
stencilAperture	mm	ステンシル開口
padToPadGap	mm	パッド間ギャップ
ipcLand	mm	IPC-7351B 公称ランド
landDeviation	mm	ランド径の偏差
landTolerance	mm	ランド径のばらつき
landPercent	%	制限値に対する割合
compliantLand	mm	適合ランド

呼び出し方

計算：1 回の呼び出し、リクエストとレスポンスの全体、そのエラー。
バッチ：この計算ツールをほかと組み合わせて、または掃引を、1 リクエストで。
目標値からの逆算：出力を目標値にする入力の値。

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "bga-land-pad",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    }
  }'

import rftools

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

result = client.calculate("bga-land-pad", {
    "ballPitch": 1,
    "ballDiameter": 0.6,
    "solderMaskDefined": 0,
    "viaInPad": 0,
    "ballType": 0,
    "landDiameter": 0.48,
})
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": "bga-land-pad",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "bga-land-pad",
	  "inputs": {
	    "ballPitch": 1,
	    "ballDiameter": 0.6,
	    "solderMaskDefined": 0,
	    "viaInPad": 0,
	    "ballType": 0,
	    "landDiameter": 0.48
	  }
	}`)
	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": "bga-land-pad",
  "values": {
    "padDia": 0.45,
    "maskOpening": 0.55,
    "maxViaDrill": 0,
    "channelWidth": 0.55,
    "escapeRoutes": 2,
    "maxTraceWidth": 0.17500000000000002,
    "stencilAperture": 0.45,
    "padToPadGap": 0.55,
    "ipcLand": 0.45,
    "landDeviation": 0.02999999999999997,
    "landTolerance": 0.05,
    "landPercent": 59.99999999999994,
    "compliantLand": 0.5
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:bga-land-pad",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "ballPitch": {
          "min": 0.3,
          "max": 1.27,
          "unit": "mm"
        },
        "ballDiameter": {
          "min": 0.15,
          "max": 0.89,
          "unit": "mm"
        },
        "solderMaskDefined": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "viaInPad": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "ballType": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "landDiameter": {
          "min": 0.05,
          "max": 1.5,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

テキストとして送られた入力。計上はされていません。

{
  "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 付き。

同じ入力で計算ツールのページを開くBGA ランドパッド計算ツール、この値で