Datei hochladen
  1. base64hub
  2. Doku
  3. HTTP-API
  4. Kodieren

POSTKodieren

Text oder Bytes in Base64 umwandeln. Standard- oder URL-sicheres Alphabet, mit oder ohne Padding, auf Wunsch mit Zeilenumbruch.

POSThttps://api.base64hub.com/v1/encode

Anfrage

Senden Sie JSON mit dem Text in input. Der Text wird als UTF-8 kodiert.

curl -s https://api.base64hub.com/v1/encode \
  -H 'Content-Type: application/json' \
  -d '{"input": "Hello, hub!"}'

Body-Parameter

NameTypBeschreibung
input erforderlichstringDer zu kodierende Text. Er wird zuerst in UTF-8-Bytes umgewandelt.
variant optional"standard" oder "url"Alphabet. url verwendet - und _ statt + und /. Standardwert "standard".
padding optionalbooleanDas abschließende = behalten. Standardwert true.
wrap optionalinteger, 0 bis 1000Nach je N Ausgabezeichen \n einfügen, keins am Ende. 76 ist MIME. Standardwert 0, kein Umbruch.

Jedes andere Feld wird mit 400 invalid_body abgelehnt.

Rohe Bytes

Um eine Datei oder beliebige Binärdaten zu kodieren, senden Sie die Bytes als application/octet-stream. Die Optionen stehen dann im Query-String: variant=url, padding=false, wrap=76.

printf '\xfb\xff\xbf' | curl -s \
  'https://api.base64hub.com/v1/encode?variant=url&padding=false' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary @-

Das Body-Limit liegt bei 1 MB. Für größere Dateien nehmen Sie das CLI, das streamt.

Antwort

200 OK · application/json
{
  "output": "SGVsbG8sIGh1YiE=",
  "variant": "standard",
  "padding": true,
  "bytes_in": 11,
  "bytes_out": 16
}
FeldTypBeschreibung
outputstringDer Base64-Text.
variantstringDas verwendete Alphabet, standard oder url.
paddingbooleanOb das =-Padding behalten wurde.
bytes_inintegerAnzahl der Eingabebytes nach der Umwandlung in UTF-8.
bytes_outintegerLänge von output, Zeilenumbrüche eingeschlossen.

Mit {"input": "foobar", "wrap": 4} ist die Ausgabe "Zm9v\nYmFy" und bytes_out gleich 9: acht Base64-Zeichen und ein Zeilenumbruch. Die Antwort oben ist zum Lesen formatiert; die API sendet sie in einer Zeile.

Fehler

StatusCodeUrsache
400invalid_bodyKein gültiges JSON, input fehlt oder ist kein String, ein ungültiger Wert für variant, padding oder wrap, ein unbekanntes Feld oder ein Query-Parameter, oder Query-Optionen zusammen mit einem JSON-Body.
413too_largeDer Body ist größer als 1 MB.
415unsupported_media_typeContent-Type ist weder application/json noch application/octet-stream.
429keinerRate-Limit erreicht; siehe Limits.

Die API-Übersicht listet alle Fehler.

Aktualisiert 22.11.2026