ForHosting KIT · Strumenti per sviluppatori

Divida il budget dei regali in base alle priorità

Organizzare regali per più persone diventa complicato quando non tutte hanno la stessa priorità.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore trasforma un budget complessivo e alcuni pesi relativi in un importo concreto per ciascun destinatario. Conserva l’intera somma fino all’ultimo centesimo, rende chiaro il criterio usato ed evita continui ritocchi al foglio di calcolo. Lei può inserire pesi semplici come 3, 2 e 1: conta soltanto il loro rapporto, quindi non occorre stabilire prima delle percentuali.

Scelga pesi che esprimano le priorità relative

Inizi indicando quanto può spendere per tutti i regali. Elenchi poi ogni destinatario e gli assegni un peso di priorità positivo. Il peso non è una somma di denaro e non deve raggiungere un totale prestabilito: descrive soltanto un rapporto. Se Alex ha peso 4 e Blair peso 2, Alex riceverà il doppio. I valori 2 e 1, oppure 40 e 20, producono lo stesso risultato. Questa flessibilità rende più facile concordare le priorità mentre il piano è ancora in evoluzione. Lei potrebbe scegliere un valore alto per i familiari più stretti, uno medio per gli amici e uno inferiore per altri impegni. Non utilizzi zero per escludere qualcuno; rimuova invece la persona dall’elenco, così l’ambito del piano rimane esplicito. Il calcolatore verifica tutti i pesi, li somma e divide ciascun valore per il totale per ricavare la quota corrispondente. I nomi restano nell’ordine inserito, così il risultato può essere confrontato facilmente con l’elenco originale.

Comprenda la ripartizione proporzionale al centesimo

I calcoli proporzionali generano spesso frazioni di centesimo. Arrotondare separatamente l’importo di ogni persona può far superare il budget o lasciare una piccola differenza. Questo calcolatore elimina il problema. Prima arrotonda il budget totale ai centesimi, poi calcola la quota frazionaria esatta di ogni destinatario e assegna la parte intera. I centesimi ancora disponibili vanno alle persone con i resti frazionari maggiori. Il procedimento è noto come metodo dei resti maggiori. Ogni importo presenta così due decimali e la somma coincide esattamente con il budget restituito. Se due destinatari hanno lo stesso resto, il centesimo aggiuntivo va a chi compare prima nell’elenco, assicurando uno spareggio stabile e deterministico. Il risultato mostra anche la quota normalizzata, per esempio 0.5 per metà del budget, e la somma di tutti i pesi. Questi dati consentono di verificare il calcolo, spiegarlo ad altri partecipanti o riprodurlo in un prospetto acquisti senza dubbi sugli arrotondamenti.

Trasformi le quote in un piano d’acquisto realistico

Consideri ogni quota come un limite di spesa o un obiettivo, non come l’obbligo di trovare un articolo a quel prezzo esatto. Cerchi regali adeguati entro l’importo e tenga presenti imposte, spedizione, confezione e acquisti condivisi. Se tali costi rientrano nel totale, li accantoni prima di inserire il budget oppure li includa nel prezzo confrontato con la quota. Può ripetere il calcolo quando cambia l’elenco, viene aggiunto un regalo collettivo o aumenta o diminuisce la disponibilità. Poiché gli stessi pesi mantengono gli stessi rapporti, modificare il totale non richiede di ricostruire il piano. In famiglia, in un comitato o in una raccolta aziendale, conservi i pesi insieme al risultato per documentare le priorità concordate. Lo strumento non giudica i rapporti e non suggerisce prodotti; applica l’aritmetica in modo coerente. Ogni richiesta API costa $0.002, mentre il browser è comodo per pianificazioni occasionali. Nessuna rete, casualità o data corrente modifica il risultato.

Casi d'uso

Pianificare i regali di famiglia

Attribuisca pesi maggiori ai familiari stretti rispettando un unico limite di spesa stagionale.

Dividere una raccolta comune

Distribuisca il denaro raccolto fra regali di ringraziamento secondo le priorità concordate.

Ricalcolare dopo una variazione

Mantenga invariate le priorità e aggiorni subito tutte le quote quando cambia il totale disponibile.

Domande frequenti

Che cosa indica un peso di priorità?

È un valore relativo. Una persona con peso 6 riceve il doppio di una persona con peso 3.

I pesi devono sommare 100?

No. Va bene qualsiasi insieme di valori positivi, perché ogni peso viene diviso per la loro somma.

Le quote sommano esattamente il budget?

Sì. Il totale è arrotondato ai centesimi e quelli residui seguono i resti frazionari maggiori.

Come viene risolta la parità per un centesimo?

Lo riceve chi compare prima nell’elenco, rendendo deterministica ogni ripetizione del calcolo.

Posso usare un budget nullo o negativo?

No. Deve essere un numero finito positivo e arrotondarsi ad almeno un centesimo.

Quanto costa una richiesta API?

Ogni richiesta costa $0.002. Lei può anche usare gratuitamente il calcolatore nel browser.

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/life/gift-budget-split

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/life/gift-budget-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_budget":240,"recipients":[{"name":"Alex","priority_weight":3},{"name":"Blair","priority_weight":2},{"name":"Casey","priority_weight":1}]}'

const res = await fetch("https://api.kit.forhosting.com/life/gift-budget-split", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_budget": 240,
    "recipients": [
      {
        "name": "Alex",
        "priority_weight": 3
      },
      {
        "name": "Blair",
        "priority_weight": 2
      },
      {
        "name": "Casey",
        "priority_weight": 1
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/gift-budget-split",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_budget": 240,
    "recipients": [
        {
            "name": "Alex",
            "priority_weight": 3
        },
        {
            "name": "Blair",
            "priority_weight": 2
        },
        {
            "name": "Casey",
            "priority_weight": 1
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/gift-budget-split", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_budget":240,"recipients":[{"name":"Alex","priority_weight":3},{"name":"Blair","priority_weight":2},{"name":"Casey","priority_weight":1}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_budget":240,"recipients":[{"name":"Alex","priority_weight":3},{"name":"Blair","priority_weight":2},{"name":"Casey","priority_weight":1}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/gift-budget-split", 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

{
  "total_budget": 240,
  "recipients": [
    {
      "name": "Alex",
      "priority_weight": 3
    },
    {
      "name": "Blair",
      "priority_weight": 2
    },
    {
      "name": "Casey",
      "priority_weight": 1
    }
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.gift_budget_split",
  "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.

Limiti

max_items 1000

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 →