Calculadora de Diagonal de um Retângulo
A API de diagonal de um retângulo recebe uma largura e uma altura e devolve o comprimento exato da diagonal, aplicando o teorema de Pitágoras ao triângulo retângulo formado por dois lados adjacentes.
Executar grátis
É a medida necessária ao dimensionar uma tela, cortar uma escora, verificar se um objeto passa por um vão de canto a canto ou validar um layout — uma chamada, um número, sem planilha e sem raiz quadrada manual. Ambas as dimensões devem ser números finitos e positivos; qualquer outro valor é rejeitado com um erro claro e nunca é cobrado.
O que é a diagonal de um retângulo
Todo retângulo esconde dois triângulos retângulos idênticos: trace uma linha de um canto ao canto oposto e você dividiu a figura ao longo de sua diagonal, tornando essa linha a hipotenusa de um triângulo cujos catetos são a largura e a altura. A calculadora de diagonal de um retângulo aplica o teorema de Pitágoras — o quadrado da diagonal é igual ao quadrado da largura mais o quadrado da altura — e devolve a raiz quadrada dessa soma. Um retângulo com três unidades de largura e quatro de altura tem diagonal exatamente igual a cinco; um quadrado de lado um tem diagonal igual à raiz quadrada de dois, cerca de 1.414214. O resultado é expresso na unidade que você informou: envie centímetros e receba centímetros, envie polegadas e receba polegadas. Como o cálculo é uma única fórmula fechada, a resposta é exata, determinística e instantânea, sem etapas de aproximação, sem solucionador iterativo e sem surpresas de arredondamento além de uma apresentação estável com seis casas decimais.
Como funcionam o cálculo e a validação
Você envia um objeto JSON com dois campos, width e height, e recebe um objeto que ecoa ambas as dimensões junto à diagonal calculada. A validação é deliberadamente rigorosa: cada dimensão deve ser um número finito e positivo. Zero, valores negativos, NaN, infinitos, campos ausentes e valores que não são números são rejeitados com um erro de entrada inválida, e chamadas rejeitadas nunca são cobradas. Strings numéricas são aceitas por conveniência, já que formulários web e parâmetros de consulta transportam tudo como texto. Internamente, a diagonal é calculada com uma primitiva de hipotenusa em vez da expressão ingênua de raiz quadrada da soma dos quadrados, o que mantém o resultado preciso mesmo para dimensões muito grandes, nas quais elevar ao quadrado primeiro poderia transbordar para o infinito. O valor final é arredondado para seis casas decimais, de modo que consumidores automatizados que comparam saídas entre máquinas e arquiteturas vejam resultados byte a byte idênticos. Não há aleatoriedade, relógio, acesso à rede nem estado oculto: a mesma entrada sempre produz a mesma saída, na API e na versão gratuita do navegador.
Onde essa medida aparece na prática
Os tamanhos de telas e displays são informados como diagonais, por isso quem monta um catálogo, uma ferramenta de comparação ou um feed de eletrônicos converte constantemente entre largura por altura e diagonal. Carpintaria e construção recorrem à diagonal sempre que uma estrutura precisa estar esquadrejada: se as duas diagonais de uma moldura retangular medem o mesmo, os cantos são ângulos retos verdadeiros. Transporte e embalagem usam a diagonal para decidir se um objeto longo cabe de canto a canto dentro de uma caixa ou por uma abertura retangular. Em trabalhos gráficos e de layout, a diagonal normaliza distâncias e dimensiona raios de canto. Este endpoint atende a todos esses casos com uma única chamada determinística executada em nossa edge global, custa US$ 0,002 por requisição e nada retém depois. O mesmo código alimenta a calculadora gratuita desta página, portanto o que você testa interativamente é exatamente o que sua integração receberá ao automatizar em escala.
Casos de uso
Ferramentas de tamanho de tela
Derive o tamanho de diagonal anunciado de um display a partir de sua largura e altura físicas, ou verifique um anúncio que informa uma medida em função da outra.
Esquadrejamento de estruturas na construção
Compare a diagonal esperada de uma moldura retangular com a medida real para confirmar que os cantos são ângulos retos verdadeiros antes da fixação.
Verificações de encaixe para transporte e armazenagem
Decida se um item cabe de canto a canto dentro de uma caixa, engradado ou abertura retangular comparando seu comprimento com a diagonal.
Perguntas frequentes
Quanto custa?
US$ 0,002 por requisição. Também é gratuito executar no seu navegador nesta página.
Qual fórmula é usada?
O teorema de Pitágoras: a diagonal é a raiz quadrada da largura ao quadrado mais a altura ao quadrado, calculada com uma primitiva de hipotenusa segura contra overflow.
Que tipo de entrada é rejeitada?
Qualquer largura ou altura que não seja um número finito e positivo: zero, negativos, NaN, infinito ou campos ausentes. Chamadas rejeitadas retornam um erro de entrada inválida e não são cobradas.
Em que unidade vem o resultado?
Na mesma unidade da sua entrada. Envie largura e altura em centímetros e a diagonal volta em centímetros.
Funciona para quadrados?
Sim. Um quadrado é um retângulo com largura e altura iguais, portanto passar o mesmo valor duas vezes retorna o lado multiplicado pela raiz quadrada de dois.
Qual é a precisão do resultado?
A diagonal é arredondada para seis casas decimais, o que mantém as saídas idênticas entre máquinas e arquiteturas.
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
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/math/diagonal-of-rectangle \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"width":3,"height":4}'const res = await fetch("https://api.kit.forhosting.com/math/diagonal-of-rectangle", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"width": 3,
"height": 4
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/diagonal-of-rectangle",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"width": 3,
"height": 4
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/diagonal-of-rectangle", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"width":3,"height":4}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"width":3,"height":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/diagonal-of-rectangle", 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
{
"width": 3,
"height": 4
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.diagonal_of_rectangle",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 1 |
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. |