Endpoints
| Méthode | Chemin | Rôle |
|---|---|---|
POST | /v1/encode | texte ou octets bruts vers Base64 ; standard ou URL-safe, remplissage, retour à la ligne |
POST | /v1/decode | Base64 vers texte, hexadécimal pour le binaire, ou les octets bruts |
POST | /v1/validate | est-ce du Base64, quel alphabet, avec remplissage, combien d’octets |
GET | /v1/health | état et version |
GET | /v1/openapi.json | la description OpenAPI 3.1 |
Les requêtes et les réponses sont en JSON. L’encodage accepte aussi des octets bruts en application/octet-stream, et le décodage peut renvoyer les octets bruts si vous les demandez avec Accept: application/octet-stream.
Une requête et sa réponse
Encoder une chaîne en Base64 URL-safe sans remplissage :
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}
Le décodage fonctionne de la même façon et vous signale quand les octets ne sont pas du texte :
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
Le décodeur est volontairement tolérant : espaces et sauts de ligne, préfixe data:...;base64,, remplissage manquant et les deux alphabets sont acceptés. Les vraies erreurs reviennent en 400 invalid_base64 avec le caractère fautif et sa position, par exemple invalid character '!' at position 4.
Limites et comportement
- Authentification : aucune, ni clé ni jeton.
- Limite de débit : 20 requêtes par tranche de 10 secondes et par adresse IP. Au-delà, Cloudflare répond avec le statut 429.
- Taille du corps : jusqu’à 1 Mo. Au-delà, la réponse est
413 too_large. - Entrées strictes : les champs JSON et les paramètres de requête inconnus sont rejetés avec
400 invalid_body: une faute de frappe dans le nom d’une option ne passe jamais inaperçue. - CORS :
Access-Control-Allow-Origin: *sur chaque réponse, pré-vérification prise en charge. - Cache : chaque réponse porte
Cache-Control: no-store.
La présentation de l’API contient le tableau complet des erreurs et les règles propres à chaque type de contenu.
Quand utiliser une API pour le Base64
Le Base64 ne coûte presque rien à calculer, et tous les langages l’intègrent : btoa dans les navigateurs, Buffer dans Node.js, le module base64 en Python. Appeler un service web pour cela a du sens quand :
- vous êtes dans un outil no-code, un tableur ou un constructeur de webhooks qui sait faire des requêtes HTTP mais pas exécuter du code ;
- vous voulez le même décodage tolérant et la même validation dans tous les langages, sans les porter ;
- vous testez ou enseignez et voulez une réponse de référence pour comparer.
Pour tout ce qui est sensible, comme des jetons ou des clés privées, préférez un outil local : les outils du navigateur de ce site, la CLI ou les paquets npm et Python donnent des résultats identiques sans que les données quittent votre machine.
FAQ
L'API base64hub est-elle vraiment gratuite ?
Oui. Il n’y a ni clé ni compte. Une limite de 20 requêtes par tranche de 10 secondes et par adresse IP la garde disponible pour tout le monde.
L'API conserve-t-elle ce que j'envoie ?
Non. Elle tourne comme un Cloudflare Worker, sans stockage, et ne journalise pas le corps des requêtes. N’envoyez quand même pas de secrets à un service web quand un outil local suffit ; la CLI b64 donne les mêmes résultats hors ligne.
Peut-on appeler l'API Base64 en JavaScript depuis le navigateur ?
Oui. Chaque réponse porte Access-Control-Allow-Origin: * et les requêtes de pré-vérification (preflight) reçoivent une réponse : fetch() fonctionne donc depuis n’importe quelle origine.
Quelle taille de fichier peut-on encoder avec l'API ?
Le corps des requêtes est limité à 1 Mo. Pour des fichiers plus gros, utilisez la CLI, qui travaille en flux, ou l’outil Fichier en Base64 dans votre navigateur.