ForHosting KIT · Strumenti per sviluppatori

Calcolatore di addobbi e luci per albero di Natale

Preparare un albero decorato è più semplice quando la lista degli acquisti parte da una quantità motivata anziché da un’ipotesi.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore moltiplica l’altezza dell’albero, espressa in livelli decorati, per la densità desiderata in ogni livello e restituisce un numero intero. Scelga una densità bassa per una composizione ariosa, una più alta per un aspetto ricco, oppure esegua calcoli separati per addobbi e luci. Il calcolo è deterministico, immediato e adatto sia alla pianificazione occasionale sia agli acquisti ricorrenti.

Trasformi un’idea decorativa in dati misurabili

Consideri l’albero come una successione di livelli decorati. L’altezza indica quanti livelli intende coprire, mentre la densità per livello rappresenta il numero medio di addobbi o luci assegnato a ciascuno. Il modello è adatto agli alberi artificiali con piani di rami evidenti e agli alberi naturali suddivisi in pratiche fasce orizzontali. Conteggi soltanto la parte che decorerà davvero: può escludere il tronco scoperto, il retro nascosto o la cima riservata a una stella. Scelga poi la densità secondo l’effetto desiderato. Una composizione leggera lascia più verde visibile; una fitta crea una superficie più ricca o luminosa. Se addobbi e luci richiedono densità diverse, li calcoli separatamente, così la stima resterà facile da spiegare, modificare e riutilizzare.

Comprenda il risultato e la regola di arrotondamento

Il calcolatore moltiplica l’altezza per la densità di ogni livello e arrotonda il risultato all’intero superiore. Questa regola è necessaria perché addobbi e punti luce sono oggetti discreti: un fabbisogno frazionario richiede un articolo intero in più. Una densità pari a zero è valida e restituisce zero, utile per registrare una categoria volutamente assente. L’altezza deve essere un numero finito maggiore di zero e la densità non può essere negativa. Il risultato è una quantità di pianificazione, non una misura esatta della capacità dei rami. Larghezza, distanza tra i rami, dimensione degli addobbi e lati visibili possono cambiare il consumo effettivo. Mantenga quindi la stessa definizione di livello in tutti i confronti.

Applichi la stima agli acquisti e all’allestimento

Usi il risultato come quantità minima di articoli interi per le ipotesi inserite. Prima dell’acquisto, lo confronti con le scorte disponibili e con le dimensioni delle confezioni. Se gli addobbi sono venduti in scatole, divida la quantità per il contenuto di ogni scatola e arrotondi nuovamente verso l’alto. Per le luci, stabilisca se la densità indica lampadine, punti LED o ganci, quindi converta il totale in fili usando la distanza dichiarata dal produttore. Può aggiungere in seguito una riserva separata per rotture, guasti o variazioni dell’ultimo momento. Tenerla fuori dalla formula conserva un valore di riferimento chiaro. Senza rete, casualità o data corrente, gli stessi dati producono sempre lo stesso numero.

Casi d'uso

Pianificare l’acquisto di addobbi

Stimi il minimo necessario prima di convertire il risultato in scatole o set disponibili in negozio.

Dimensionare un impianto luminoso

Calcoli i punti luce dalla densità scelta e trasformi il totale in fili con spaziatura nota.

Uniformare gli allestimenti per eventi

Applichi una densità costante ad alberi di altezze diverse per uniformare piani e liste d’acquisto.

Domande frequenti

Che cosa restituisce il calcolatore?

Restituisce un numero intero di addobbi o luci ottenuto moltiplicando l’altezza per la densità di ogni livello.

Perché il risultato viene arrotondato verso l’alto?

Le decorazioni sono oggetti interi. L’arrotondamento superiore copre un fabbisogno frazionario con il pezzo utilizzabile successivo.

Che cosa deve rappresentare un livello?

Usi un piano di rami o una fascia orizzontale e mantenga questa definizione in ogni confronto.

Posso calcolare insieme addobbi e luci?

Esegua calcoli separati se impiegano densità o unità diverse, così ogni acquisto rimane chiaro.

La densità può essere zero?

Sì. Una densità pari a zero restituisce zero, ma l’altezza deve comunque essere positiva.

Quanto costa una richiesta API?

L’API costa $0.002 per richiesta e il calcolo nel browser non richiede elaborazione sul server.

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/date/christmas-tree

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/date/christmas-tree \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"height":8,"density_per_level":12.5}'

const res = await fetch("https://api.kit.forhosting.com/date/christmas-tree", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "height": 8,
    "density_per_level": 12.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/christmas-tree",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "height": 8,
    "density_per_level": 12.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/christmas-tree", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"height":8,"density_per_level":12.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"height":8,"density_per_level":12.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/christmas-tree", 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

{
  "height": 8,
  "density_per_level": 12.5
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.christmas_tree",
  "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 →