Charger un fichier
  1. base64hub
  2. Docs
  3. API HTTP
  4. Décoder

POSTDécoder

Retrouvez le texte, ou les octets d’origine, à partir de Base64. L’entrée peut utiliser l’un ou l’autre alphabet, omettre le remplissage ou porter un préfixe data:.

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

Requête

Envoyez le Base64 en JSON dans input, ou comme corps entier avec Content-Type: text/plain.

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: application/json' \
  -d '{"input": "SGVsbG8sIGh1YiE="}'

Paramètres du corps

NomTypeDescription
input obligatoirestringLe Base64 à décoder.

Avec Content-Type: text/plain, le corps entier est l’entrée, sans JSON autour. Cet endpoint n’accepte pas de paramètres de requête.

Ce que le décodeur accepte :

  • des espaces, tabulations et sauts de ligne n’importe où, par exemple du Base64 coupé selon MIME ;
  • un préfixe data:<type>;base64,, qui est retiré ;
  • l’absence de remplissage = ;
  • l’alphabet standard et l’alphabet URL-safe, même mélangés.

Réponse

200 OK · application/json
{
  "output": "Hello, hub!",
  "utf8": true,
  "bytes_out": 11
}

Quand les octets décodés ne sont pas de l’UTF-8 valide, output vaut null et les octets arrivent en hexadécimal. Voici la réponse pour +/+/ :

200 OK · application/json
{
  "output": null,
  "utf8": false,
  "hex": "fbffbf",
  "bytes_out": 3
}
ChampTypeDescription
outputstring ou nullLe texte décodé, ou null quand les octets ne sont pas de l’UTF-8.
utf8booleanIndique si les octets sont de l’UTF-8 valide.
hexstringLes octets en hexadécimal minuscule. Présent seulement quand utf8 vaut false.
bytes_outintegerNombre d’octets décodés.

Octets bruts

Pour récupérer un fichier, demandez les octets avec Accept: application/octet-stream. Le corps de la réponse contient alors les données décodées, sans JSON autour.

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: text/plain' \
  -H 'Accept: application/octet-stream' \
  --data-binary @photo.b64 -o photo.jpg

Erreurs

Un Base64 invalide est rejeté avec 400 invalid_base64. Le message nomme le premier problème et sa position, comptée à partir de 0 une fois les espaces retirés :

400 Bad Request · application/json
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
StatutCodeCause
400invalid_base64Un caractère hors des deux alphabets, un = au milieu, plus de deux =, ou une longueur qui laisse un seul caractère dans le dernier groupe.
400invalid_bodyJSON non valide, input manquant ou qui n’est pas une chaîne, champ inconnu, paramètre de requête, ou corps qui n’est pas en UTF-8.
413too_largeLe corps dépasse 1 Mo.
415unsupported_media_typeLe Content-Type n’est ni application/json ni text/plain.
429aucunLimite de débit atteinte ; voir les limites.

Pour vérifier une chaîne sans recevoir de statut d’erreur, utilisez Valider.

Mis à jour 22 nov. 2026