Code-128-Nutzlast und Prüfsumme erstellen
Prüfen Sie, ob ein Etikettenwert in Code 128 Zeichensatz B passt, und erhalten Sie die Symbolwerte für den Drucker: KIT-128 beginnt mit dem Startwert 104 und hat die Prüfsumme 77. Nicht erlaubte Zeichen werden mit ihrer Position gemeldet. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Text
- KIT-128
- Nutzdaten
- KIT-128
- Codesatz
- B
- Wert des Startsymbols
- 104
- Wert des Prüfsymbols
- 77
Dieser Code-128-Nutzlastgenerator prüft Text vor dem Rendern, wandelt jedes zulässige Zeichen in den Symbolwert des Satzes B um und berechnet die vorgeschriebene Modulo-103-Prüfsumme. Die Antwort enthält die unveränderte Nutzlast, das Startsymbol, die geordneten Datensymbole und den Prüfsummenwert. Damit eignet sie sich für Etikettensoftware, Druckerintegrationen, Tests und Fehlersuche; unzulässige Zeichen führen stets zu einer präzisen Eingabemeldung.
Erkennen Sie genau, welcher Text zulässig ist
Code 128 bezeichnet eine Familie kompakter Symbolcodierungen und ist keine direkte Abbildung beliebiger Unicode-Texte. Dieses Werkzeug verwendet bewusst Satz B, der sich für übliche Kennungen mit Buchstaben, Ziffern, Satzzeichen und Leerzeichen eignet. Zulässig ist druckbares ASCII von U+0020, dem Leerzeichen, bis U+007E, der Tilde.
Der Bereich enthält englische Groß- und Kleinbuchstaben, Dezimalziffern und geläufige Satzzeichen. Tabulatoren, Zeilenumbrüche, Steuerzeichen, Buchstaben mit Akzent, Emoji und alle übrigen Zeichen werden abgelehnt. Diese Grenze ist ausdrücklich festgelegt, denn stilles Ersetzen oder Entfernen würde eine Kennung verändern und könnte ein Etikett dem falschen Datensatz zuordnen.
Bei einem Fehler nennt die Meldung den nullbasierten Index und den Unicode-Codepunkt, sodass Sie den betreffenden Wert eindeutig finden. Leerer Text ist ebenfalls ungültig; die Höchstlänge begrenzt die Ausführung. Benötigen Sie Steuerzeichen, FNC-Symbole oder die Sätze A und C, verwenden Sie einen Encoder mit einem entsprechend erweiterten Vertrag.
So entstehen Symbolwerte und Prüfsumme
Im Satz B entsteht der Datenwert eines zulässigen Zeichens, indem 32 von seinem ASCII-Code abgezogen wird. Das Leerzeichen wird zu null, die Ziffer Null zu 16, das große A zu 33 und die Tilde zu 94. Die Berechnung beginnt mit 104 und addiert jedes Datensymbol, multipliziert mit seiner ab eins gezählten Position.
Das erste Symbol hat das Gewicht eins, das zweite zwei und so weiter. Ein Renderer setzt dieses Symbol hinter die Daten und vor das Stoppmuster; es ist keine Dezimalzahl, die Sie an den Ursprungstext anhängen. Die ausgegebenen Zwischenwerte machen jeden Summanden prüfbar.
Da ausschließlich Ganzzahlarithmetik eingesetzt wird, liefert dieselbe Eingabe in jeder Umgebung stets dieselbe Antwort.
Verwenden Sie das Ergebnis sicher für Etiketten
Die Ausgabe richtet sich an Software, die Code-128-Symbolwerte bereits in Balken, Druckerbefehle oder Testaussagen umsetzen kann. Auch das Stoppmuster fehlt im Zahlenarray, weil es strukturell ist und nicht in die Prüfsumme eingeht. Prüfen Sie in automatisierten Abläufen vor dem Senden des Druckbefehls und bewahren Sie die Antwort beim erzeugten Artefakt auf.
Vergleichen Sie in Tests sowohl Reihenfolge als auch Prüfsumme. Ohne Netzwerk, Speicher, Zufall oder Uhrzeit bleibt das Ergebnis reproduzierbar.
Anwendungsfälle
Druckerbefehle vorbereiten
Prüfen Sie eine Lagerkennung und ermitteln Sie die exakten Werte des Satzes B, bevor Sie einen druckerspezifischen Befehl aufbauen.
Abgelehnte Kennungen untersuchen
Finden Sie Steuerzeichen, Buchstaben mit Akzent oder andere unzulässige Codepunkte, bevor sie in die Etikettenverarbeitung gelangen.
Häufige Fragen
Welche Zeichen werden unterstützt?
Druckbares ASCII vom Leerzeichen (U+0020) bis zur Tilde (U+007E), also das hier verwendete Repertoire von Code 128 Satz B.
Muss ich die Prüfsumme an den Text anhängen?
Nein. Sie ist ein Code-128-Symbolwert für den Renderer und kein Textbestandteil der ursprünglichen Nutzlast.
Erzeugt das Werkzeug ein Barcodebild?
Nein. Es liefert geprüfte Nutzlast und Symbolwerte. Balken, Ruhezonen, Maße und Bildformate übernimmt ein Renderer.
Wie wird die Prüfsumme von Code 128 berechnet?
Man beginnt mit 104, dem Startwert von Zeichensatz B, und addiert jedes Datensymbol multipliziert mit seiner Position, gezählt ab eins. Die Summe wird durch 103 geteilt und der Rest behalten: Für KIT-128 ist dieser Rest, die Prüfsumme, 77.
Was passiert bei Umlauten oder Zeilenumbrüchen im Text?
Der Text wird mit einer genauen Meldung abgelehnt, die die Position des Zeichens ab null sowie seinen Unicode-Codepunkt nennt. Nichts wird entfernt oder ersetzt, denn ein veränderter Bezeichner könnte ein Etikett dem falschen Datensatz zuordnen.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/enc/barcode-code128-payload \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"KIT-128"}'const res = await fetch("https://api.kit.forhosting.com/enc/barcode-code128-payload", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "KIT-128"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/barcode-code128-payload",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "KIT-128"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/barcode-code128-payload", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"KIT-128"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"KIT-128"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/barcode-code128-payload", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"text": "KIT-128"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.barcode_code128_payload",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_chars | 4096 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
So entstehen Symbolwerte und Prüfsumme
Das Array data_symbol_values bewahrt die Reihenfolge und enthält weder Start noch Prüfsumme. Dadurch bleiben Nutzdaten und Struktursymbole klar getrennt. start_symbol_value ist 104, der normgerechte Wert für Start B. Der Rest modulo 103 erscheint als checksum_symbol_value.
Verwenden Sie das Ergebnis sicher für Etiketten
Ein Renderer gibt zuerst das Startsymbol, dann alle Werte aus data_symbol_values, anschließend checksum_symbol_value und zuletzt das vorgeschriebene Stoppmuster aus. Das Feld payload bleibt unverändert, damit sich die Berechnung der exakten Quelle zuordnen lässt. Das Werkzeug zeichnet weder SVG noch PNG, wählt keine Abmessungen, ergänzt keine Ruhezonen und prüft nicht, ob ein physischer Druck scanbar ist; dies sind Aufgaben des Renderings und der Druckkontrolle. Im Browser prüfen Sie sofort; automatisierte API-Aufrufe kosten jeweils $0.002.
Integrationsbeispiele
Regressionstests erstellen
Erzeugen Sie prüfbare Symbolarrays und Prüfsummen, um einen unabhängigen Code-128-Renderer mit deterministischen Werten zu vergleichen.
Technische Fragen
Was geschieht bei einem Emoji oder Zeilenumbruch?
Die Anfrage endet mit invalid_input und bezeichnet das erste unzulässige Zeichen anhand seines Index und Unicode-Codepunkts.
Was kostet die Verwendung der API?
Jeder API-Aufruf kostet $0.002. Dieselbe deterministische Berechnung können Sie im Browser kostenlos ausführen.