Polegadas lineares

Informe length, width e height positivos em polegadas ou centímetros; qualquer lado ausente, nulo, negativo ou que não seja número é recusado como invalid_input para que uma medida em branco nunca pareça um passe livre no medidor. A API pré-paga cobra US$ 0,002 por item bem-sucedido quando apps de arrumação, páginas de mala e checklists de viagem precisam do mesmo total linear determinístico a partir de servidores e SDK.

O que são polegadas lineares e quais lados medir

Envie os campos obrigatórios length, width e height como números JSON ou strings numéricas em uma única unidade compartilhada. O unit opcional aceita in para polegadas, o padrão, ou cm para centímetros; os alias units, measure_unit e dim_unit são honrados. 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 teto em polegadas lineares da companhia, por exemplo 45 para muitas cabines dos Estados Unidos ou 62 para muitas peças despachadas. Qualquer dimensão que não seja um número finito estritamente positivo falha com invalid_input, porque um lado zero ou negativo não é uma mala física. Entradas idênticas sempre produzem o mesmo JSON: soma mais o fator exato polegada-centímetro de 2.54, sem rede, sem semente aleatória e sem relógio de parede.

Como ler linear_inches, os lados em duas unidades e o limite opcional

Se a requisição for válida, a resposta devolve length, width, height e unit após arredondamento estável, mais length_in, width_in e height_in para que entradas em centímetros apareçam em polegadas antes da soma. O campo principal linear_inches é a soma desses três lados em polegadas e é o número que você compara com a tabela publicada da companhia. O campo formula reitera que linear_inches é length_in mais width_in mais height_in, e method é sempre sum_dimensions_to_linear_inches para o cliente ramificar com uma string estável. Quando você envia limit, o corpo também inclui within_limit como booleano, remaining_inches como folga se a mala passa, e excess_inches como o excesso se estoura. Esses três campos de teto somem por completo se você não enviar um limite, para que um total simples continue simples. Use linear_inches sozinho no dia de arrumar a mala; use os lados convertidos para polegadas quando o comprador digitou centímetros de uma ficha europeia; use os campos de limite quando o checkout ou a checklist da viagem precisar mostrar passou ou falhou ao lado do número da tarifa. Lados obrigatórios ausentes, valores não finitos e qualquer dimensão que não seja um número positivo falham com invalid_input e não são cobrados. Este endpoint não baixa políticas de marca; você ou o seu produto fornecem o limite numérico que corresponde ao bilhete que de fato comprou.

Uso da API, preço, fluxos de arrumação e limites práticos

Use a calculadora gratuita no navegador no dia de arrumar, ao comparar duas malas na loja ou numa demonstração escolar de conversão de unidades sem abrir planilha. Em grupos com várias malas, chame uma vez por peça para cada uma ser julgada na própria classe de cabine ou porão. 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, um estimador de taxas, uma página de mala ou um 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. Quem publica SDK pode mapear linear_inches, within_limit, remaining_inches e excess_inches numa tabela pequena ao lado dos três lados: a mesma forma que os viajantes veem nos cartazes de tamanho no balcão.