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

Überblick über die HTTP-API

Eine kleine JSON-API für Base64 unter https://api.base64hub.com/v1. Kein Schlüssel, kein Konto, CORS aktiviert. Diese Seite beschreibt, was alle Endpunkte gemeinsam haben.

Basis-URL und Endpunkte

https://api.base64hub.com/v1
MethodePfadZweck
POST/v1/encodeText oder rohe Bytes in Base64
POST/v1/decodeBase64 in Text, Hex oder rohe Bytes
POST/v1/validateBase64 prüfen und beschreiben
GET/v1/healthStatus und Version
GET/v1/openapi.jsonOpenAPI-3.1-Beschreibung der API

GET https://api.base64hub.com/ leitet (302) auf diese Seite weiter. Anfragen brauchen keine Authentifizierung.

Anfrageformate

Jeder Endpunkt akzeptiert eine feste Auswahl an Content-Types und beantwortet alles andere mit 415 unsupported_media_type.

EndpunktContent-TypeBody
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-streamrohe Bytes; Optionen im Query-String
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plaindas Base64 selbst

Bodys müssen UTF-8 sein (außer rohen Bytes für encode). Unbekannte JSON-Felder und unbekannte Query-Parameter werden mit 400 invalid_body abgelehnt, statt ignoriert zu werden, sodass eine falsch geschriebene Option nie unbemerkt wirkungslos bleibt. Query-Optionen werden nur zusammen mit einem Body vom Typ application/octet-stream gelesen.

Antworten sind JSON (application/json; charset=utf-8), außer bei decode mit Accept: application/octet-stream, das die rohen Bytes zurückgibt.

CORS und Header

Jede Antwort enthält:

Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff

Preflight-Anfragen per OPTIONS erhalten 204 mit den erlaubten Methoden und den Request-Headern Content-Type und Accept, sodass sich die API mit fetch() von jeder Webseite aus aufrufen lässt.

Limits

  • Body-Größe: 1 MB (1048576 Bytes). Größere Bodys erhalten 413 too_large.
  • Rate-Limit: 20 Anfragen pro 10 Sekunden und IP-Adresse auf Pfaden unter /v1/. Das Limit setzt Cloudflare vor der API durch. Darüber erhalten Sie Status 429 mit der eigenen Antwort von Cloudflare, die kein JSON ist und keinen CORS-Header hat; ein Skript im Browser sieht also einen Netzwerkfehler statt eines lesbaren Bodys.
  • Zeilenumbruch (wrap): von 0 bis 1000 Zeichen.

Die API hat keinen Zustand und protokolliert keine Request-Bodys. Für große Dateien oder Geheimnisse nutzen Sie ein lokales Tool wie das b64-CLI.

Fehler

Fehler der API selbst sind JSON mit einem stabilen code und einer lesbaren message:

{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
StatusCodeWann
400invalid_bodyfehlerhaftes JSON, falsche Feldtypen, fehlendes input, unbekannte Felder oder Query-Parameter, ein Body, der kein UTF-8 ist
400invalid_base64die Eingabe für decode ist kein Base64; die Meldung nennt das Problem und seine Position
404not_foundunbekannter Pfad
405method_not_allowedfalsche Methode für den Pfad; der Header Allow listet die richtigen
413too_largeBody über 1 MB
415unsupported_media_typeein Content-Type, den der Endpunkt nicht akzeptiert
429keinerRate-Limit erreicht; die Antwort kommt von Cloudflare, nicht als JSON
500internal_errorein unerwarteter Fehler in der API

Validieren meldet ungültiges Base64 mit Status 200, denn „ungültig“ ist die Antwort auf die gestellte Frage. Siehe Validieren.

OpenAPI

Die maschinenlesbare Beschreibung liegt unter https://api.base64hub.com/v1/openapi.json. Importieren Sie sie in einen API-Client oder einen Codegenerator, um fertige Anfragen für jeden Endpunkt zu erhalten.

Aktualisiert 22.11.2026