Pulgadas lineales de equipaje

Introduzca largo, ancho y alto positivos; las dimensiones no positivas se rechazan como invalid_input para que una medida faltante no pase por válida en la puerta de embarque.

Cómo funcionan las pulgadas lineales y qué dimensiones medir

La medida lineal del equipaje es simplemente largo más ancho más alto de la maleta tal como pasará por el medidor o a la cinta. Mida las dimensiones exteriores incluyendo ruedas y asas fijas cuando así lo defina la aerolínea o el operador; los laterales blandos que se comprimen suelen cotizarse aún a tamaño expandido completo salvo que la política diga lo contrario. Un limit no positivo, si se proporciona, también se rechaza. Envíe los campos obligatorios length, width y height como números JSON o cadenas numéricas en la misma unidad. El unit opcional acepta in para pulgadas (predeterminado) o cm para centímetros; se admiten los alias units, measure_unit y dim_unit. Los alias l, len y depth se asignan 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 máximo lineal permitido en esa misma unidad—por ejemplo cuarenta y cinco para una regla habitual de cabina en Estados Unidos, o ciento quince para un techo métrico de facturado. Un length, width o height no positivo es error duro del contrato porque un lado cero o negativo no es una maleta física. Los techos de magnitud mantienen la aritmética finita en el Worker. Entradas idénticas siempre producen JSON idéntico: suma pura y un factor pulgada-centímetro fijo de 2.54, sin red, sin semilla aleatoria y sin reloj de pared.

Lectura de campos lineales, duales y de aprobación o fallo

En caso de éxito la respuesta devuelve length, width, height y unit tras redondeo estable, más linear igual a la suma en la unidad de entrada. linear_in y linear_cm presentan siempre el mismo tamaño físico en pulgadas y centímetros para que una página de transportista estadounidense y una lista europea compartan una llamada API. El campo formula indica que linear es length más width más height, y method es siempre sum_dimensions_linear_measure para ramificación estable en clientes. Cuando suministra limit, la respuesta incluye también within_limit y meets_limit como el mismo booleano, over_by como cuántas unidades excede el techo si falla, y under_by como el margen restante si aprueba. Use linear solo para un total rápido; use linear_in frente a linear_cm cuando necesite ambas pantallas regionales; use los campos de límite cuando un flujo de compra o lista de empaque deba mostrar aprobación o fallo junto al número de la aerolínea. Dimensiones obligatorias ausentes, valores no finitos y lados no positivos fallan con invalid_input y no se cobran tras el rechazo del motor. Este endpoint no obtiene políticas de marca; usted o su producto suministran el límite numérico que coincide con las reglas tarifarias vigentes.

Uso de la API, precios, flujos de viaje y límites prácticos

Llame a la calculadora gratuita en el navegador para el día del empaque, la compra de una cabina nueva y demostraciones de conversión de unidades sin instalar una hoja de cálculo. En grupos con varias maletas, llame una vez por pieza para que cada una respete su propio límite de clase. 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, estimador de tasas de equipaje, página de maletas o aplicación de empaque necesite un contrato estable bajo saldo KIT a $0.002 por ítem exitoso; los fallos de validación nunca consumen saldo. Combine este endpoint con convertidores de peso o planificadores de viaje cuando la siguiente pregunta sea el peso o el coste del itinerario, pero mantenga las comprobaciones de tamaño aquí para que la aritmética sea auditable. Los autores de SDK pueden mapear linear, linear_in, linear_cm y within_limit a tablas de aprobación o fallo junto a los tres lados—la misma forma que ven los viajeros en los carteles de tamaño en el mostrador del aeropuerto.