Jede Zeile mit Text umschließen

Leere oder nur aus Leerzeichen bestehende Eingaben werden mit einem klaren invalid_input-Fehler abgelehnt, damit ein leeres Formular nie wie eine gelungene Umschließung wirkt.

Was das Umschließen jeder Zeile bedeutet und wann es hilft

Die Vorgaben nutzen ein gerades doppeltes Anführungszeichen auf beiden Seiten, sodass drei Namen zu drei Namen in Anführungszeichen werden, bereit zum Einfügen in JSON, CSV oder eine Konfigurationsdatei. Ist skip_empty true, bleibt eine Zeile der Länge null leer, sodass Absatzlücken erhalten bleiben, während Inhaltszeilen umschlossen werden. Eine vollständig leere oder nur aus Leerzeichen bestehende Eingabe ist ein harter Fehler: Es gibt kein sinnvolles umschlossenes Dokument zurückzugeben, und Aufrufer sollen das als invalid_input behandeln, nicht als Erfolg mit null Zeilen.

Wie Sie die API aufrufen und was die Antwort enthält

Übergeben Sie auf einer Seite eine ausdrücklich leere Zeichenkette, bleibt diese Seite leer, sodass Sie nur voranstellen oder nur anhängen können. Werden beide Seiten zu leeren Zeichenketten, wird der Aufruf abgelehnt, weil Umschließen mit nichts keine Umschließung ist. Senden Sie lieber den rohen mehrzeiligen Körper, statt alles vorab zu verbinden, wenn Sie echte Semantik pro Zeile wollen. Senden Sie einen JSON-Körper mit einem Pflichtfeld string namens text (Aliasse input, value, string, s, content und body). Optional fügen Sie prefix (Aliasse pre und left) und suffix (Aliasse post und right) als Zeichenketten von höchstens vierundsechzig Zeichen sowie skip_empty (Aliasse skip_blank, ignore_empty und skip_blanks) als boolean hinzu. Wird prefix oder suffix weggelassen, gilt jeweils ein gerades doppeltes Anführungszeichen. Der text-Wert muss nach dem gesamten Leerzeichen-Trim nicht leer sein und darf hunderttausend Zeichen nicht überschreiten, damit eine einzelne Anfrage Worker- oder Browserspeicher bei riesigen Einfügungen nicht erschöpft. Bei Erfolg spiegelt die Antwort input als die gesendete Originalkette, text als das vollständig umschlossene, mit LF verbundene Ergebnis, prefix und suffix als die wirksamen Affixe, skip_empty als das wirksame Flag, line_count als die Anzahl der Segmente nach der Teilung, wrapped_count als wie viele dieser Segmente die Affixe tatsächlich erhielten, lines als ein geordnetes Array der umschlossenen Ketten und message als eine kurze englische Zusammenfassung. Fehlgeschlagene Prüfung—fehlendes text, ein Nicht-string-Wert, eine überlange Nutzlast, leerer Inhalt nach dem gesamten Trim, ein Nicht-string- oder überlanges Affix, beide Affixe leer oder ein Nicht-boolean-skip_empty—liefert invalid_input und wird nie berechnet. Der Preis ist ein fester $0.002 pro erfolgreicher Anfrage mit Einheit item. Beim Integrieren prüfen Sie text oder lines für den umschlossenen Inhalt, wrapped_count wenn skip_empty greift, und behandeln invalid_input als Clientfehler bei leeren Formularen, nicht als Abrechnungsereignis.

Praktische Tipps, Grenzen und verwandte Suchen

Setzen Sie prefix auf ein Größer-als-Zeichen und ein Leerzeichen bei leerem suffix, um Notizen in ein Markdown-Blockzitat zu verwandeln. Setzen Sie prefix auf ein öffnendes Listenelement-Tag und suffix auf das passende Schlusstag, um Markup-Zeilen zu bauen. Hin-und-zurück-Prüfungen für Tests sind einfach: senden Sie drei kurze Zeilen und erwarten Sie drei Zeilen in Anführungszeichen mit line_count drei und wrapped_count drei; senden Sie eine Leerzeile zwischen zwei Wörtern mit skip_empty true und erwarten Sie, dass die mittlere Zeile leer bleibt; senden Sie absichtlich eine leere Zeichenkette oder nur Leerzeichen, um invalid_input und die Meldung zu bestätigen, die eine nicht leere Zeichenkette verlangt; senden Sie leeres prefix und leeres suffix zusammen, um die Ablehnung beider Leeren zu bestätigen. Behalten Sie bewusste abschließende Umbrüche im Blick: ein abschließendes LF erzeugt ein leeres letztes Segment, das umschlossen wird, sofern skip_empty nicht true ist. Fehlgeschlagene Aufgaben, die invalid_input liefern, verbrauchen kein vorausbezahltes Guthaben, was Formularprüfung und negative CI-Tests günstig hält.