Indentar líneas con espacios

La entrada vacía o solo de espacios se rechaza con un error invalid_input claro para que la automatización nunca trate un pegado en blanco como una sangría exitosa. La ruta es lógica de cadenas pura y determinista—sin red, sin semillas aleatorias, sin dependencia del reloj—de modo que el ejecutor gratuito del navegador y la API prepaga devuelven el mismo JSON cada vez que la invoca.

Qué significa la sangría por línea con espacios y cuándo usarla

La mayoría de los editores sangran una selección insertando espacios o tabulaciones al inicio de cada línea seleccionada; esta capacidad hace el mismo trabajo como una transformación enfocada y lista para API. La entrada completa vacía o solo de espacios es un error duro: no hay un documento sangrado significativo que devolver, y los clientes deben tratarlo como invalid_input y no como un éxito de cero líneas.

Cómo llamar a la API y qué contiene la respuesta

El valor spaces debe ser un entero finito de cero a doscientos inclusive. Prefiera enviar el cuerpo multilínea en bruto en lugar de unir de antemano las líneas si desea semántica real por línea. Envíe un cuerpo JSON con un campo string obligatorio text (alias input, value, string, s, content y body) y un campo entero obligatorio spaces (alias n, indent, count, amount y pad). El texto debe ser no vacío tras recortar los espacios generales y no debe superar cien mil caracteres para que una sola petición no agote la memoria del Worker o del navegador con pegados enormes. En caso de éxito la respuesta devuelve input como la cadena original enviada, spaces como el entero normalizado aplicado, text como el resultado totalmente sangrado unido con LF, line_count como el número de líneas tras la división (incluidas las vacías), lines como un array ordenado de las cadenas de línea sangradas, chars_before y chars_after como las longitudes de las cadenas original y sangrada, chars_added como cuántos caracteres introdujeron los prefijos en total (típicamente line_count por spaces, ajustado si la normalización de saltos acortó el original), y message como un resumen breve en inglés que informa del recuento de líneas, spaces y caracteres añadidos. La validación fallida—text ausente, un valor que no es string, una carga sobredimensionada, contenido vacío tras el recorte general o un spaces inválido—devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición exitosa con unidad item. Al integrar, aserte sobre text o lines para el contenido sangrado, compare opcionalmente chars_added en comprobaciones de regresión y trate invalid_input como un error del cliente en envíos de formulario en blanco y no como un evento de facturación.

Consejos prácticos, límites y búsquedas relacionadas

Las comprobaciones de ida y vuelta para pruebas son fáciles: envíe dos líneas cortas con spaces igual a cuatro y espere que cada línea empiece con cuatro espacios; envíe una línea en blanco entre contenido y confirme que esa línea vacía también lleva el mismo prefijo; envíe deliberadamente cadena vacía o solo espacios para confirmar invalid_input y el mensaje que pide una cadena no vacía; envíe un spaces negativo o un decimal para confirmar invalid_input en el campo de recuento. Si necesita quitar espacios iniciales y finales por línea en lugar de añadir espacios, use la herramienta hermana de recorte por línea; si necesita rellenar una sola cadena a un ancho total con un carácter de relleno a izquierda o derecha, use el relleno de cadena; si necesita JSON con sangría estructural, use un formateador JSON. Las tareas fallidas que devuelven invalid_input no consumen saldo prepagado, lo que mantiene barata la validación de formularios y las pruebas negativas de CI. Respete los topes de caracteres y de spaces documentados arriba al enviar volcados grandes por la API.