ForHosting KIT · Strumenti per sviluppatori

Verifica colore caldo o freddo in base alla tonalità

Il verificatore converte un colore esadecimale nel relativo angolo di tonalità e lo confronta con due centri fissi.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Il rosso a 0 gradi è il centro caldo, il ciano a 180 gradi quello freddo; determina il risultato il centro più vicino. Le tonalità esattamente sul confine vengono classificate come fredde, così il pareggio ha una soluzione stabile. La risposta comprende colore normalizzato, tonalità, categoria e distanza angolare, rendendo la decisione trasparente e ripetibile in strumenti grafici, test e procedure automatizzate.

Come viene decisa la categoria

Questo strumento usa una definizione geometrica sul cerchio RGB standard. Il rosso, a 0 gradi, è il centro della metà calda; il ciano, a 180 gradi, quello della metà fredda. Dopo la conversione del valore esadecimale, misura la distanza angolare più breve dal centro caldo. Una distanza inferiore a 90 gradi produce caldo; da 90 gradi in poi produce freddo. Le divisioni sono quindi a 90 e 270 gradi. Poiché quei punti sono equidistanti, entrambi i pareggi esatti vengono assegnati alla categoria fredda. La regola esplicita impedisce risultati diversi al confine. L'output espone tonalità e distanza utilizzate, quindi la decisione è verificabile. È una convenzione pratica per i colori digitali: illuminazione, colori circostanti e contesto culturale possono comunque cambiare la temperatura percepita.

Come inserire il colore e leggere l'output

Inserisca un colore RGB esadecimale a tre cifre, per esempio #F60, oppure a sei, per esempio #FF6600. Il cancelletto è facoltativo e le lettere possono essere maiuscole o minuscole. La risposta espande la forma breve e restituisce sei cifre maiuscole nel campo color. Hue_degrees indica la posizione calcolata da 0 fino a meno di 360 gradi; category contiene caldo o freddo. Distance_from_warm_center mostra la distanza dal rosso lungo il percorso più breve, mentre i campi dei centri dichiarano gli angoli di riferimento. Vicino a 90 gradi il colore è prossimo alla divisione e può sembrare sensibile al contesto, ma il calcolo rimane stabile. Nero, bianco e grigi esatti sono rifiutati: i tre canali sono uguali, perciò la tonalità non è definita e qualsiasi categoria sarebbe arbitraria.

Impiego in procedure deterministiche

Un'etichetta deterministica aiuta a filtrare, verificare o instradare una tavolozza senza ripetere valutazioni umane. Uno script di design system può controllare che una raccolta calda contenga soltanto risultati caldi. Un catalogo può aggiungere un filtro di temperatura ai campioni cromatici, mentre un generatore di grafici può scegliere una famiglia contrastante dopo aver letto la categoria. Il calcolo non usa rete, casualità, stato memorizzato o data corrente: lo stesso input dà sempre lo stesso output. Tramite API ogni richiesta costa $0.002; l'esecutore nel browser usa lo stesso calcolo puro. Consideri l'etichetta una proprietà misurabile, non una teoria completa dell'aspetto cromatico. Saturazione e luminosità non spostano la tonalità, ma incidono sulla percezione. Per scelte artistiche raffinate, valuti poi il colore accanto allo sfondo e alla tavolozza previsti.

Casi d'uso

Organizzare una tavolozza digitale

Divida i campioni cromatici in gruppi caldi e freddi stabili prima della revisione grafica finale.

Verificare i token di design

Controlli che i token semantici restino nella metà di tonalità prevista dopo ogni modifica.

Etichettare i colori dei prodotti

Aggiunga una categoria deterministica ai campioni di catalogo per filtri e flussi commerciali.

Domande frequenti

Quali angoli sono caldi?

Sono calde le tonalità distanti meno di 90 gradi dal rosso: da 0 a meno di 90 e oltre 270 fino a meno di 360 gradi.

Che cosa accade esattamente sul confine?

A 90 o 270 gradi la distanza dai centri è identica. La regola deterministica assegna entrambi i casi al freddo.

Perché grigio, nero e bianco vengono rifiutati?

Hanno canali RGB uguali e nessun angolo di tonalità definito; assegnare una categoria violerebbe la regola.

Saturazione o luminosità cambiano la categoria?

No. Influenzano l'aspetto, ma la classificazione usa intenzionalmente solo l'angolo di tonalità.

Quali formati sono accettati?

Sono ammessi valori RGB esadecimali di tre o sei cifre, con o senza cancelletto; non sono ammessi alfa o nomi.

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/color/warm-or-cool

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/color/warm-or-cool \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"color":"#E85D04"}'

const res = await fetch("https://api.kit.forhosting.com/color/warm-or-cool", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "color": "#E85D04"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/warm-or-cool",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "color": "#E85D04"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/warm-or-cool", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"color":"#E85D04"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"color":"#E85D04"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/warm-or-cool", 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

{
  "color": "#E85D04"
}

Esempio di risposta

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