Entourer chaque ligne

Une entrée vide ou uniquement composée d’espaces est rejetée avec une erreur invalid_input claire afin qu’un formulaire blanc ne ressemble jamais à un entourage réussi. Le chemin est une logique de chaînes pure et déterministe—sans réseau, sans graines aléatoires, sans dépendance d’horloge—de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON à chaque appel.

Ce que signifie entourer chaque ligne et quand cela aide

Les valeurs par défaut utilisent un guillemet droit de chaque côté, de sorte que trois noms deviennent trois noms entre guillemets, prêts à coller dans du JSON, du CSV ou un fichier de configuration. Lorsque skip_empty vaut true, une ligne de longueur nulle reste vide afin que les blancs de paragraphe survivent tandis que les lignes de contenu sont entourées. Une entrée entière vide ou uniquement d’espaces est une erreur dure : il n’y a pas de document entouré significatif à renvoyer, et l’appelant doit le traiter comme invalid_input plutôt que comme un succès à zéro ligne.

Comment appeler l’API et ce que contient la réponse

Lorsque vous passez une chaîne vide explicite d’un côté, ce côté reste vide afin de ne préfixer que ou de ne suffixer que. Si les deux côtés deviennent des chaînes vides, l’appel est rejeté, car entourer avec rien n’est pas un entourage. Préférez envoyer le corps multiligne brut plutôt que de tout joindre à l’avance lorsque vous voulez une sémantique réelle par ligne. Envoyez un corps JSON avec un champ string obligatoire text (alias input, value, string, s, content et body). Incluez éventuellement prefix (alias pre et left) et suffix (alias post et right) comme chaînes d’au plus soixante-quatre caractères chacune, et skip_empty (alias skip_blank, ignore_empty et skip_blanks) comme boolean. Lorsque prefix ou suffix est omis, chacun vaut par défaut un guillemet droit. La valeur de text doit être non vide après trim global des espaces et ne doit pas dépasser cent mille caractères, afin qu’une seule requête n’épuise pas la mémoire du Worker ou du navigateur sur d’énormes collages. En cas de succès, la réponse renvoie input comme la chaîne d’origine envoyée, text comme le résultat entièrement entouré joint par LF, prefix et suffix comme les affixes effectifs, skip_empty comme le drapeau effectif, line_count comme le nombre de segments après découpage, wrapped_count comme le nombre de ces segments qui ont réellement reçu les affixes, lines comme un tableau ordonné des chaînes entourées, et message comme un court résumé en anglais. Une validation échouée—text manquant, valeur non string, charge trop grande, contenu vide après trim global, affixe non string ou trop long, les deux affixes vides ou un skip_empty non boolean—renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item. À l’intégration, assertez sur text ou lines pour le contenu entouré, sur wrapped_count lorsque skip_empty entre en jeu, et traitez invalid_input comme une erreur client sur les formulaires blancs plutôt que comme un événement de facturation.

Conseils pratiques, limites et recherches associées

Définissez prefix comme un chevron droit et un espace avec un suffix vide pour transformer des notes en citation de bloc markdown. Définissez prefix comme une balise d’élément de liste ouvrante et suffix comme la balise fermante correspondante pour construire des rangées de balisage. Les contrôles aller-retour pour les tests sont simples : envoyez trois lignes courtes et attendez trois lignes entre guillemets avec line_count trois et wrapped_count trois ; envoyez une ligne vide entre deux mots avec skip_empty true et attendez que la ligne du milieu reste vide ; envoyez délibérément une chaîne vide ou seulement des espaces pour confirmer invalid_input et le message qui demande une chaîne non vide ; envoyez prefix vide et suffix vide ensemble pour confirmer le rejet des deux vides. Gardez à l’esprit les sauts finaux volontaires : un LF final crée un dernier segment vide qui est entouré sauf si skip_empty vaut true. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient bon marché la validation de formulaires et les tests négatifs de CI.