Polegadas lineares de bagagem

Informe comprimento, largura e altura positivos; dimensões não positivas são rejeitadas como invalid_input para que uma medida ausente nunca passe por válida no portão.

Como funcionam as polegadas lineares e quais dimensões medir

A medida linear da bagagem é simplesmente comprimento mais largura mais altura da mala como ela passará pelo medidor ou na esteira. Meça as dimensões externas incluindo rodas e alças fixas quando for assim que a companhia ou o operador define o limite; laterais macios que comprimem ainda costumam ser cotados no tamanho expandido pleno, salvo se a política disser o contrário. Envie os campos obrigatórios length, width e height como números JSON ou strings numéricas na mesma unidade. O unit opcional aceita in para polegadas (padrão) ou cm para centímetros; os alias units, measure_unit e dim_unit são aceitos. Os alias l, len e depth mapeiam para length; w e breadth para width; h e ht para height. O limit opcional (alias max_linear, max, airline_limit, max_inches) é o máximo linear permitido nessa mesma unidade—por exemplo quarenta e cinco para uma regra comum de cabine nos Estados Unidos, ou cento e quinze para um teto métrico de despachada. length, width ou height não positivos são erro duro do contrato porque um lado zero ou negativo não é uma mala física. limit não positivo, quando fornecido, também é rejeitado. Tetos de magnitude mantêm a aritmética finita no Worker. Entradas idênticas sempre produzem JSON idêntico: soma pura e um fator polegada-centímetro fixo de 2.54, sem rede, sem semente aleatória e sem relógio de parede.

Leitura dos campos lineares, dual-unidade e aprovação ou falha

Em caso de sucesso a resposta devolve length, width, height e unit após arredondamento estável, mais linear igual à soma na unidade de entrada. linear_in e linear_cm sempre apresentam o mesmo tamanho físico em polegadas e centímetros para que uma página de transportadora dos EUA e uma lista europeia compartilhem uma chamada API. O campo formula declara que linear é length mais width mais height, e method é sempre sum_dimensions_linear_measure para ramificação estável nos clientes. Quando você fornece limit, a resposta também inclui within_limit e meets_limit como o mesmo booleano, over_by como quantas unidades a mala excede o teto quando falha, e under_by como a folga restante quando aprova. Use linear sozinho para um total rápido; use linear_in versus linear_cm quando precisar das duas telas regionais; use os campos de limite quando um fluxo de compra ou lista de arrumação deva mostrar aprovação ou falha ao lado do número da companhia. Dimensões obrigatórias ausentes, valores não finitos e lados não positivos falham com invalid_input e não são cobrados após a rejeição do motor. Este endpoint não busca políticas de marca; você ou seu produto fornecem o limite numérico que corresponde às regras tarifárias vigentes.

Uso da API, preços, fluxos de viagem e limites práticos

Chame a calculadora gratuita no navegador para o dia da arrumação, a compra de uma bagagem de mão nova e demonstrações de conversão de unidades sem instalar planilha. Em grupos com várias malas, chame uma vez por peça para que cada uma fique dentro do seu limite de classe. Envie um corpo JSON com length, width, height, unit opcional e limit opcional (ou os alias documentados). Use a API pré-paga quando um portal de viagens, estimador de taxas de bagagem, página de malas ou app de arrumação precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo. Combine este endpoint com conversores de peso ou planejadores de viagem quando a próxima pergunta for peso da mala ou custo do itinerário, mas mantenha as checagens de tamanho aqui para que a aritmética continue auditável. Autores de SDK podem mapear linear, linear_in, linear_cm e within_limit em tabelas que mostram aprovação ou falha ao lado dos três lados—a mesma forma que os viajantes veem nos cartazes de tamanho no balcão do aeroporto.