ForHosting KIT · Strumenti per sviluppatori

Semplificare e scalare un rapporto di 2 o 3 termini

Questo strumento riunisce le due operazioni che in genere servono insieme. Inserisca due o tre numeri non negativi per ridurne il rapporto ai minimi termini interi.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Aggiunga un totale desiderato per calcolare anche la quantità proporzionale assegnata a ciascun termine. Il risultato mostra il rapporto originale, la forma irriducibile, il numero di parti, il moltiplicatore e i valori ridimensionati. Sono ammessi interi, zeri e decimali finiti, quindi lo strumento è adatto a ricette, ripartizioni, miscele, programmi e verifiche scolastiche.

Riduca due o tre termini senza modificarne la relazione

Un rapporto descrive quote relative, perciò moltiplicare o dividere ogni termine per lo stesso valore lascia invariata la relazione. Il calcolatore trasforma anzitutto ogni numero in una rappresentazione intera esatta. Questo passaggio è importante con decimali finiti come 1.5:2.25, perché considerarli testo approssimato può dare una risposta poco pratica. In seguito trova il massimo comune divisore condiviso da tutti i termini e divide ogni intero per tale divisore. Per esempio, 18:24 diventa 3:4, mentre 6:9:15 diventa 2:3:5. Lo zero è consentito come singolo termine, perché 0:4:8 ha la forma ridotta 0:1:2. Tuttavia, i termini non possono essere tutti nulli: 0:0 non contiene un numero positivo di parti e non è ridimensionabile. La risposta conserva i valori originali e presenta il rapporto semplificato sia come elenco sia come testo separato da due punti, risultando adatta tanto alle persone quanto ai programmi.

Adatti le parti semplificate a un totale esatto

Dopo la semplificazione, il calcolatore somma i termini ridotti per ricavare il numero complessivo di parti. Divide il totale desiderato per tale numero, ottiene il fattore di scala e moltiplica ogni termine semplificato per quel fattore. Se un budget viene ripartito nel rapporto 2:3:5 e il totale disponibile è 1,000, le parti sono dieci, ciascuna vale 100 e il risultato è 200, 300 e 500. Lo stesso metodo vale quando le quantità sono frazionarie. Un rapporto 1:2 adattato a un totale di 10 produce 3.33333333333 e 6.66666666667 con precisione numerica stabile. Il calcolo parte dagli interi semplificati, rendendo il procedimento trasparente e conservando le proporzioni previste. Un totale pari a zero è valido e restituisce zero per ogni termine. I totali negativi sono rifiutati perché una ripartizione negativa non rientra nel modello non negativo di questo calcolatore.

Scelga dati validi e interpreti i campi restituiti

Fornisca esattamente due o tre termini numerici finiti. Un termine negativo genera sempre un errore di input, così come un valore mancante, NaN, infinito, un rapporto composto solo da zeri o un elenco della lunghezza sbagliata. Anche il totale desiderato deve essere finito e non negativo. Nella risposta, original_ratio ripete i termini accettati, mentre simplified_ratio contiene la forma intera irriducibile. parts_total è la somma dei termini semplificati. scale_factor indica il valore di una parte per il totale richiesto e scaled_ratio elenca le quantità finali nello stesso ordine dell’input. Non vengono associate unità: se il totale rappresenta grammi, euro, litri, posti od ore, ogni valore usa la medesima unità. Nelle automazioni, utilizzi l’elenco numerico restituito invece di analizzare il testo con i due punti e applichi l’arrotondamento specifico del settore solo in seguito.

Casi d'uso

Ridimensionare una ricetta o miscela

Riduca le proporzioni degli ingredienti e calcoli la quantità di ciascun componente necessaria per un nuovo totale.

Ripartire un budget fisso

Trasformi i pesi dei reparti in quote trasparenti che corrispondono al budget disponibile.

Controllare esercizi sui rapporti

Verifichi la forma irriducibile di un rapporto a due o tre numeri e il suo adattamento a un totale.

Domande frequenti

Quanto costa il calcolo del rapporto?

L’API costa $0.002 per richiesta. Lei può anche eseguire gratuitamente nel browser lo stesso calcolo deterministico.

Posso semplificare un rapporto di tre parti?

Sì. Inserisca esattamente due o tre termini; verranno ridotti insieme tramite il loro massimo comune divisore.

Sono ammessi termini decimali?

Sì. I decimali finiti vengono convertiti in una relazione intera esatta prima della semplificazione.

Un rapporto può contenere zero?

Un singolo termine può essere zero, ma almeno uno deve essere maggiore di zero. Un rapporto composto solo da zeri non è ridimensionabile.

Che cosa accade se un termine è negativo?

La richiesta restituisce un errore di input non valido. Tutti i termini devono essere non negativi.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/calc2/ratio-simplify

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/calc2/ratio-simplify \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"terms":[2,3,5],"total":100}'

const res = await fetch("https://api.kit.forhosting.com/calc2/ratio-simplify", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "terms": [
      2,
      3,
      5
    ],
    "total": 100
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/ratio-simplify",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "terms": [
        2,
        3,
        5
    ],
    "total": 100
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/ratio-simplify", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"terms":[2,3,5],"total":100}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"terms":[2,3,5],"total":100}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/ratio-simplify", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "terms": [
    2,
    3,
    5
  ],
  "total": 100
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.ratio_simplify",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →