Charger un fichier
  1. base64hub
  2. Docs
  3. API HTTP
  4. Encoder

POSTEncoder

Transformez du texte ou des octets en Base64. Alphabet standard ou URL-safe, avec ou sans remplissage, et retour à la ligne en option.

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

Requête

Envoyez du JSON avec le texte dans input. Le texte est encodé en UTF-8.

curl -s https://api.base64hub.com/v1/encode \
  -H 'Content-Type: application/json' \
  -d '{"input": "Hello, hub!"}'

Paramètres du corps

NomTypeDescription
input obligatoirestringTexte à encoder. Il est d’abord converti en octets UTF-8.
variant facultatif"standard" ou "url"Alphabet. url utilise - et _ au lieu de + et /. Par défaut "standard".
padding facultatifbooleanConserve le = final. Par défaut true.
wrap facultatifinteger, de 0 à 1000Insère \n tous les N caractères de sortie, jamais à la fin. 76 correspond à MIME. Par défaut 0, sans retour à la ligne.

Tout autre champ est rejeté avec 400 invalid_body.

Octets bruts

Pour encoder un fichier ou n’importe quelles données binaires, envoyez les octets en application/octet-stream. Les options passent alors dans la query string : variant=url, padding=false, wrap=76.

printf '\xfb\xff\xbf' | curl -s \
  'https://api.base64hub.com/v1/encode?variant=url&padding=false' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary @-

Le corps est limité à 1 Mo. Pour des fichiers plus gros, utilisez la CLI, qui travaille en flux.

Réponse

200 OK · application/json
{
  "output": "SGVsbG8sIGh1YiE=",
  "variant": "standard",
  "padding": true,
  "bytes_in": 11,
  "bytes_out": 16
}
ChampTypeDescription
outputstringLe texte Base64.
variantstringL’alphabet utilisé, standard ou url.
paddingbooleanIndique si le remplissage = a été conservé.
bytes_inintegerNombre d’octets en entrée après conversion en UTF-8.
bytes_outintegerLongueur de output, sauts de ligne compris.

Avec {"input": "foobar", "wrap": 4}, la sortie est "Zm9v\nYmFy" et bytes_out vaut 9 : huit caractères Base64 et un saut de ligne. La réponse ci-dessus est mise en forme pour la lecture ; l’API l’envoie sur une seule ligne.

Erreurs

StatutCodeCause
400invalid_bodyJSON non valide, input manquant ou qui n’est pas une chaîne, variant, padding ou wrap incorrect, champ ou paramètre de requête inconnu, ou options dans la query string avec un corps JSON.
413too_largeLe corps dépasse 1 Mo.
415unsupported_media_typeLe Content-Type n’est ni application/json ni application/octet-stream.
429aucunLimite de débit atteinte ; voir les limites.

La présentation de l’API liste toutes les erreurs.

Mis à jour 22 nov. 2026