ForHosting KIT · Conversores de unidades

Conversor de grandezas

5 pés são 1,524 metro, e pedir para transformar quilogramas em metros recebe uma recusa em vez de um número inventado. Converta dentro de comprimento, massa, volume, tempo e temperatura, de milímetros a milhas e de miligramas a toneladas. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Valor: 5
De: Ft
To: M

Você obtém

Resultado: 1,524 m
Tipo: length
Valor em SI: 1,524
Unidade SI: m

Um conversor de grandezas recebe um número finito e dois nomes de unidade e devolve a mesma grandeza física na unidade de destino — mas só quando as duas unidades medem o mesmo tipo de coisa. Comprimento continua comprimento, massa continua massa, volume continua volume, tempo continua tempo e temperatura continua temperatura. Estudantes, operadores de depósito, técnicos de laboratório e scripts de automação preenchem os mesmos três campos: o valor que têm, a unidade em que ele está e a unidade de que precisam.

O que é um tipo de grandeza e por que pares mistos falham

Uma grandeza física é um número vezes uma unidade, mas a unidade não é um rótulo livre: ela pertence a um tipo de grandeza. Comprimento, massa, volume, tempo e temperatura são cinco tipos diferentes. Você pode reescalar cinco pés em metros porque os dois nomes medem comprimento.

Não pode reescalar cinco quilogramas em metros porque massa e comprimento não são a mesma grandeza, por mais prefixos que se cole. Este conversor de grandezas grava essa regra como contrato de primeira ordem. Cada token aceito leva exatamente um tipo e um fator exato até uma única base SI: metro para comprimento, quilograma para massa, metro cúbico para volume, segundo para tempo e kelvin para temperatura.

A conversão dentro de um tipo é, portanto, um produto-quociente determinístico, salvo a temperatura, que é afim: Celsius e Fahrenheit não compartilham um zero comum, então o motor passa pelo kelvin com os deslocamentos publicados 273.15 e 459.67 em vez de fingir que existe um único fator de escala. A conversão entre tipos não é conversão de unidades.

Contrato de entrada, temperatura e formato da resposta

Ambas se restringem a um enum fechado para que o formulário web seja um seletor, não uma armadilha de texto livre. Os tokens de comprimento são mm, cm, m, km, in, ft, yd e mi. Os de massa são mg, g, kg, t para a tonelada métrica, oz e lb para a libra avoirdupois internacional.

Os de volume são ml, l, m3, gal para o galão líquido US e qt para o quarto líquido US. Os de tempo são s, min, h e d. Os de temperatura são c, f e k.

Tokens desconhecidos falham. Nos tipos lineares, factor é o multiplicador exato da unidade de origem para a de destino via a base SI. Temperaturas que cairiam abaixo do zero absoluto são rejeitadas.

Valores negativos são permitidos nos tipos lineares porque deltas com sinal aparecem em estoque e laboratório; zero é permitido; só magnitudes não finitas são rejeitadas.

Onde um conversor de grandezas vale a pena

Salas de aula usam um conversor de grandezas para que os alunos treinem folhas mistas SI e consuetudinárias dos EUA sem inverter um fator à mão. Um professor pode pedir cinco pés em metros e esperar 1.524, ou cem graus Celsius em Fahrenheit e esperar 212, e um plugin LMS pode marcar os mesmos itens com este oráculo determinístico — inclusive os que devem ser marcados errados porque o aluno tentou converter quilogramas em metros. A validação que falha não consome saldo.

Mantenha as requisições pequenas, fixe o resultado arredondado nos testes e você obtém saltos do mesmo tipo, reproduzíveis, para deveres, scripts de depósito e edge workers, sem montar uma biblioteca de álgebra computacional. Conversores de um só tipo continuam sendo a landing certa quando a busca é só comprimento, só massa ou só temperatura; esta página é o conversor genérico de grandezas que exige que as duas unidades sejam compatíveis antes de devolver um número.

Casos de uso

Deveres com unidades mistas e correção LMS

Deixe os alunos converterem 5 ft em m ou 100 °C em °F e falhar de forma fechada ao tentar quilogramas em metros, com um oráculo determinístico para autocorreção.

Cadernos de laboratório que misturam SI e US

Converta miligramas em onças e mililitros em quartos líquidos US quando um protocolo cita massa e volume em dois sistemas na mesma página.

Cotações de frete e scripts de agendamento

Passe quilogramas a libras, metros cúbicos a galões US e horas a segundos em frete ou filas de trabalho sem uma biblioteca geral de unidades.

Perguntas frequentes

Quais tipos de grandeza posso converter?

Comprimento (mm, cm, m, km, in, ft, yd, mi), massa (mg, g, kg, t, oz, lb), volume (ml, l, m3, gal, qt), tempo (s, min, h, d) e temperatura (c, f, k). gal e qt são líquido US.

Por que a temperatura não é uma simples multiplicação?

Celsius e Fahrenheit não compartilham um zero. O conversor passa ambos pelo kelvin com os deslocamentos publicados e emite a escala de destino. Valores abaixo do zero absoluto são rejeitados.

O que acontece se eu misturar unidades de tipos diferentes?

O conversor recusa. Quilogramas não viram metros porque massa e comprimento são grandezas diferentes, então você recebe uma mensagem clara em vez de um número inventado. Escolha duas unidades do mesmo tipo.

Qual galão, quarto e libra o conversor usa?

O galão líquido dos EUA e o quarto líquido dos EUA para volume, e a libra avoirdupois internacional para massa. A tonelada é a tonelada métrica, então confira a sua fonte se ela se referir a outra.

Posso digitar valores negativos?

Sim, em comprimento, massa, volume e tempo, porque diferenças com sinal aparecem em estoques e registros. Em temperatura, porém, qualquer valor abaixo do zero absoluto é recusado.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/conv/quantity-converter

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/conv/quantity-converter \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":5,"from":"ft","to":"m"}'

const res = await fetch("https://api.kit.forhosting.com/conv/quantity-converter", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "value": 5,
    "from": "ft",
    "to": "m"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/conv/quantity-converter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "value": 5,
    "from": "ft",
    "to": "m"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/conv/quantity-converter", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"value":5,"from":"ft","to":"m"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"value":5,"from":"ft","to":"m"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/conv/quantity-converter", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "value": 5,
  "from": "ft",
  "to": "m"
}

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Se você pedir para transformar quilogramas em metros, a tarefa recusa com invalid_input em vez de inventar um número. Este endpoint multiplica os tipos lineares por uma base SI — metro, quilograma, metro cúbico ou segundo — e leva a temperatura pelo kelvin com o deslocamento afim correto.

O que é um tipo de grandeza e por que pares mistos falham

Os fatores nunca vêm da rede nem do relógio de parede; são as definições SI e consuetudinárias dos EUA publicadas, gravadas numa tabela minúscula, para que o mesmo pedido produza sempre o mesmo JSON.

Contrato de entrada, temperatura e formato da resposta

Envie por POST um corpo JSON com três campos obrigatórios. value é a magnitude numérica a converter e deve ser um número finito; números JSON e strings numéricas são aceitos, mas NaN, Infinity, strings vazias e valores ausentes falham com invalid_input nomeando o campo. from é a unidade de origem e to é a unidade de destino. Um par cujos tipos diferem — por exemplo from kg to m — é um tipo de grandeza incompatível e também falha com invalid_input; esse erro não é cobrado. Em caso de sucesso o corpo devolve value, from e to na forma canônica, result como a magnitude convertida arredondada a doze casas decimais para goldens estáveis, unit como o token de destino para que os clientes exibam o número com a unidade, e nomeia kind. Respostas de temperatura omitem factor porque um mapa afim não é um único multiplicador; ainda assim devolvem si_value em kelvin.

Onde um conversor de grandezas vale a pena

Laboratórios convertem miligramas em onças e mililitros em quartos US quando um protocolo mistura sistemas; balcões de envio convertem quilogramas em libras e metros cúbicos em galões ao cotar frete; agendadores convertem horas em segundos quando uma API a jusante só fala tempo SI. Como a implementação é parse puro do tier A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.

Perguntas técnicas

Como converto uma grandeza entre duas unidades?

Envie um número finito em value mais from e to da lista fechada de unidades. Quando as duas unidades compartilham o tipo, a API devolve o resultado convertido e o token da unidade de destino.

O que acontece se as duas unidades forem de tipos diferentes?

A tarefa falha com invalid_input nomeando os tipos de grandeza incompatíveis — por exemplo quilogramas (massa) para metros (comprimento). Pedidos de tipos mistos não são cobrados.

Quanto custa o conversor de grandezas?

A ferramenta do navegador é gratuita. As solicitações à API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que é um tipo de grandeza e por que pares mistos falham

Contrato de entrada, temperatura e formato da resposta

Onde um conversor de grandezas vale a pena

Casos de uso

Deveres com unidades mistas e correção LMS

Cadernos de laboratório que misturam SI e US

Cotações de frete e scripts de agendamento

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

O que é um tipo de grandeza e por que pares mistos falham

Contrato de entrada, temperatura e formato da resposta

Onde um conversor de grandezas vale a pena

Perguntas técnicas

obrigado