Pulgadas lineales

Introduzca length, width y height positivos en pulgadas o centímetros; cualquier lado ausente, nulo, negativo o no numérico se rechaza como invalid_input para que una medida en blanco no parezca un pase libre en el medidor. La API de prepago factura $0.002 por ítem exitoso cuando aplicaciones de empaque, fichas de maletas y listas de viaje necesitan el mismo total lineal determinista desde servidores y SDK.

Qué son las pulgadas lineales y qué lados debe medir

Envíe los campos obligatorios length, width y height como números JSON o cadenas numéricas en una sola unidad compartida. El unit opcional acepta in para pulgadas, valor predeterminado, o cm para centímetros; se honran los alias units, measure_unit y dim_unit. Los alias l, len y depth corresponden a length; w y breadth a width; h y ht a height. El limit opcional (alias max_linear, max, airline_limit, max_inches) es el techo en pulgadas lineales de la aerolínea, por ejemplo 45 para muchas cabinas de Estados Unidos o 62 para muchas piezas de bodega. Cualquier dimensión que no sea un número finito estrictamente positivo falla con invalid_input, porque un lado cero o negativo no es una maleta física. Entradas idénticas producen siempre el mismo JSON: suma más el factor exacto pulgada-centímetro de 2.54, sin red, sin semilla aleatoria y sin reloj de pared.

Cómo leer linear_inches, los lados en dos unidades y el límite opcional

Esos tres campos de techo se omiten por completo si usted no envía un tope, de modo que un total simple sigue siendo un total simple. Este extremo no descarga políticas de marca; usted o su producto aportan el límite numérico que corresponde al billete que de verdad compró. Si la petición es válida, la respuesta devuelve length, width, height y unit tras un redondeo estable, más length_in, width_in y height_in para que las entradas en centímetros se vean en pulgadas antes de sumarse. El campo principal linear_inches es la suma de esos tres lados en pulgadas y es la cifra que usted compara con la tabla publicada de la aerolínea. El campo formula reitera que linear_inches es length_in más width_in más height_in, y method es siempre sum_dimensions_to_linear_inches para que los clientes ramifiquen con una cadena estable. Cuando usted aporta limit, el cuerpo incluye también within_limit como booleano, remaining_inches como holgura si la maleta cabe, y excess_inches como el exceso si se pasa. Use linear_inches solo para el control del día de empaque; use los lados convertidos a pulgadas cuando el comprador tecleó centímetros de una ficha europea; use los campos de límite cuando el pago o la lista del viaje deban mostrar apto o no junto al número de la tarifa. Lados obligatorios ausentes, valores no finitos y cualquier dimensión que no sea un número positivo fallan con invalid_input y no se facturan.

Uso de la API, precio, flujos de empaque y límites prácticos

Use la calculadora gratuita en el navegador el día de hacer la maleta, al comparar dos maletas en una tienda o en una demostración escolar de conversión de unidades sin abrir una hoja de cálculo. En grupos con varias maletas, llame una vez por pieza para que cada una se juzgue según su propia clase de cabina o bodega. Envíe un cuerpo JSON con length, width, height, unit opcional y limit opcional (o los alias documentados). Use la API de prepago cuando un portal de viajes, un estimador de tasas, una ficha de maleta o una aplicación de empaque necesiten un contrato estable con saldo KIT a $0.002 por ítem exitoso; los fallos de validación no consumen saldo. Quienes publiquen SDK pueden mapear linear_inches, within_limit, remaining_inches y excess_inches a una tabla pequeña junto a los tres lados: la misma forma que ven los viajeros en los carteles de tamaño del mostrador.