Ü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
| Methode | Pfad | Zweck |
|---|---|---|
POST | /v1/encode | Text oder rohe Bytes in Base64 |
POST | /v1/decode | Base64 in Text, Hex oder rohe Bytes |
POST | /v1/validate | Base64 prüfen und beschreiben |
GET | /v1/health | Status und Version |
GET | /v1/openapi.json | OpenAPI-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.
| Endpunkt | Content-Type | Body |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | rohe Bytes; Optionen im Query-String |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/plain | das 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 Status429mit 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"}}
| Status | Code | Wann |
|---|---|---|
| 400 | invalid_body | fehlerhaftes JSON, falsche Feldtypen, fehlendes input, unbekannte Felder oder Query-Parameter, ein Body, der kein UTF-8 ist |
| 400 | invalid_base64 | die Eingabe für decode ist kein Base64; die Meldung nennt das Problem und seine Position |
| 404 | not_found | unbekannter Pfad |
| 405 | method_not_allowed | falsche Methode für den Pfad; der Header Allow listet die richtigen |
| 413 | too_large | Body über 1 MB |
| 415 | unsupported_media_type | ein Content-Type, den der Endpunkt nicht akzeptiert |
| 429 | keiner | Rate-Limit erreicht; die Antwort kommt von Cloudflare, nicht als JSON |
| 500 | internal_error | ein 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