Secciones de la documentación

Calculadora de apertura diagonal y tamaño de taladro

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

Slug aperture-diagonal. Obtenga la diagonal de esquina a esquina de una abertura rectangular más la herramienta estándar que la cubre: la broca que despeja la diagonal o la fresa que se ajusta al lado corto y al radio de la esquina que deja.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de aperture-diagonal
Nombre	Unidad	Rango	Valor predeterminado	Descripción
apertureLengthnúmero	mm	0.05 … 500	2	Longitud de apertura
apertureWidthnúmero	mm	0.05 … 500	1	Anchura de apertura
routerBitnúmero	mm	0 … 10	0	La fresa que usará su fabricante. Déjela en 0 para tomar la mayor herramienta en stock que cabe en el lado corto; el radio de esquina y el aviso de óvalo siguen a la fresa en uso.

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de aperture-diagonal
Campo	Unidad	Descripción
diagonalprincipal	mm	Diagonal de esquina a esquina
coveringDrillSize	mm	Broca más pequeña que la cubre
drillOversize	mm	Sobremedida de la broca
shortSide	mm	Lado corto
routerBitSize	mm	Fresa en uso
cornerRadius	mm	Radio de esquina que deja el fresado

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "aperture-diagonal",
    "inputs": {
      "apertureLength": 2,
      "apertureWidth": 1,
      "routerBit": 0
    }
  }'

import rftools

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

result = client.calculate("aperture-diagonal", {"apertureLength": 2, "apertureWidth": 1, "routerBit": 0})
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": "aperture-diagonal",
    "inputs": {
      "apertureLength": 2,
      "apertureWidth": 1,
      "routerBit": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "aperture-diagonal",
	  "inputs": {
	    "apertureLength": 2,
	    "apertureWidth": 1,
	    "routerBit": 0
	  }
	}`)
	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": "aperture-diagonal",
  "values": {
    "diagonal": 2.23606797749979,
    "shortSide": 1,
    "coveringDrillSize": 2.25,
    "drillOversize": 0.013932022500210195,
    "routerBitSize": 1,
    "cornerRadius": 0.5
  },
  "warnings": [
    "The corner radius the cutter leaves (0.500 mm) is a large fraction of the short side — the routed opening will read as an oval rather than a rectangle"
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:aperture-diagonal",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Geometry; tooling grid is stocked metric PCB tooling in 0.05 mm steps. 1 in = 25.4 mm exactly.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "apertureLength": {
          "min": 0.05,
          "max": 500,
          "unit": "mm"
        },
        "apertureWidth": {
          "min": 0.05,
          "max": 500,
          "unit": "mm"
        },
        "routerBit": {
          "min": 0,
          "max": 10,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "apertureLength": 2,
      "apertureWidth": 1,
      "routerBit": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de apertura diagonal y tamaño de taladro, con estos valores