Sections de la documentation

Calculateur de diagonale d'ouverture et de taille de perçage

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

Slug aperture-diagonal. Obtenez la diagonale d'un angle à l'autre d'une ouverture rectangulaire et l'outil fourni pour la recouvrir : la perceuse qui efface la diagonale ou la fraise qui adapte le côté court et le rayon d'angle qu'il quitte.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de aperture-diagonal
Nom	Unité	Plage	Valeur par défaut	Description
apertureLengthnombre	mm	0.05 … 500	2	Longueur de l'ouverture
apertureWidthnombre	mm	0.05 … 500	1	Largeur de l'ouverture
routerBitnombre	mm	0 … 10	0	La fraise de détourage qu'utilisera votre fabricant. Laissez 0 pour prendre le plus grand outil en stock qui tient dans le petit côté ; le rayon d'angle et l'avertissement d'ovale suivent la fraise utilisée.

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de aperture-diagonal
Champ	Unité	Description
diagonalprincipale	mm	Diagonale d'angle à angle
coveringDrillSize	mm	Plus petit foret qui la couvre
drillOversize	mm	Surcote du foret
shortSide	mm	Petit côté
routerBitSize	mm	Fraise utilisée
cornerRadius	mm	Rayon d'angle laissé par le détourage

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

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

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de diagonale d'ouverture et de taille de perçage, avec ces valeurs