Endpunkte
| Methode | Pfad | Funktion |
|---|---|---|
POST | /v1/encode | Text oder rohe Bytes in Base64; Standard oder URL-sicher, Padding, Zeilenumbruch |
POST | /v1/decode | Base64 in Text, Hex für Binärdaten oder die rohen Bytes |
POST | /v1/validate | ist es Base64, welches Alphabet, mit Padding, wie viele Bytes |
GET | /v1/health | Status und Version |
GET | /v1/openapi.json | die Beschreibung nach OpenAPI 3.1 |
Anfragen und Antworten sind JSON. Encode nimmt auch rohe Bytes als application/octet-stream an, und Decode kann rohe Bytes zurückgeben, wenn Sie sie mit Accept: application/octet-stream anfordern.
Eine Anfrage und ihre Antwort
Einen String als URL-sicheres Base64 ohne Padding kodieren:
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
Decode funktioniert genauso und sagt Ihnen, wenn die Bytes kein Text sind:
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
Der Decoder ist absichtlich tolerant: Leerzeichen und Zeilenumbrüche, ein Präfix data:...;base64,, fehlendes Padding und beide Alphabete werden akzeptiert. Echte Fehler kommen als 400 invalid_base64 mit dem falschen Zeichen und seiner Position zurück, zum Beispiel invalid character '!' at position 4.
Limits und Verhalten
- Authentifizierung: keine, weder Schlüssel noch Token.
- Rate-Limit: 20 Anfragen pro 10 Sekunden und IP-Adresse. Darüber erhalten Sie Status 429 von Cloudflare.
- Body-Größe: bis 1 MB. Größere Bodys erhalten
413 too_large. - Strenge Eingaben: Unbekannte JSON-Felder und Query-Parameter werden mit
400 invalid_bodyabgelehnt, ein Tippfehler in einem Optionsnamen bleibt also nie unbemerkt. - CORS:
Access-Control-Allow-Origin: *bei jeder Antwort, Preflight wird beantwortet. - Caching: Jede Antwort hat
Cache-Control: no-store.
Die API-Übersicht enthält die vollständige Fehlertabelle und die Regeln für jeden Content-Type.
Wann sich eine API für Base64 lohnt
Base64 ist billig zu berechnen, und jede Sprache hat es eingebaut: btoa im Browser, Buffer in Node.js, das Modul base64 in Python. Einen Webdienst dafür aufzurufen, ist sinnvoll, wenn
- Sie in einem No-Code-Tool, einer Tabellenkalkulation oder einem Webhook-Baukasten arbeiten, der HTTP-Anfragen stellen, aber keinen Code ausführen kann;
- Sie in jeder Sprache dieselbe tolerante Dekodierung und Validierung wollen, ohne sie zu portieren;
- Sie testen oder unterrichten und eine Referenzantwort zum Vergleichen brauchen.
Für alles Sensible, etwa Tokens oder private Schlüssel, ist ein lokales Tool die bessere Wahl: Die Browser-Tools auf dieser Website, das CLI oder die Pakete für npm und Python liefern identische Ergebnisse, ohne dass die Daten Ihren Rechner verlassen.
Häufige Fragen
Ist die base64hub-API wirklich kostenlos?
Ja. Es gibt keinen Schlüssel und kein Konto. Ein Rate-Limit von 20 Anfragen pro 10 Sekunden und IP-Adresse hält sie für alle verfügbar.
Speichert die API, was ich sende?
Nein. Sie läuft als Cloudflare Worker ohne Speicher und protokolliert keine Request-Bodys. Trotzdem gilt: Schicken Sie keine Geheimnisse an einen Webdienst, wenn ein lokales Tool genügt; das b64-CLI liefert dieselben Ergebnisse offline.
Kann ich die Base64-API aus JavaScript im Browser aufrufen?
Ja. Jede Antwort trägt Access-Control-Allow-Origin: *, und Preflight-Anfragen werden beantwortet, fetch() funktioniert also von jedem Origin aus.
Wie große Dateien kann ich mit der API kodieren?
Request-Bodys sind auf 1 MB begrenzt. Für größere Dateien nehmen Sie das CLI, das streamt, oder das Tool Datei in Base64 im Browser.