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

Présentation de l'API HTTP

Une petite API JSON pour le Base64, à l’adresse https://api.base64hub.com/v1. Sans clé, sans compte, CORS activé. Cette page décrit ce que tous les endpoints ont en commun.

URL de base et endpoints

https://api.base64hub.com/v1
MéthodeCheminRôle
POST/v1/encodetexte ou octets bruts vers Base64
POST/v1/decodeBase64 vers texte, hexadécimal ou octets bruts
POST/v1/validatevérifier du Base64 et le décrire
GET/v1/healthétat et version
GET/v1/openapi.jsondescription OpenAPI 3.1 de l’API

GET https://api.base64hub.com/ redirige (302) vers cette page. Les requêtes ne demandent aucune authentification.

Formats de requête

Chaque endpoint accepte un ensemble fixe de types de contenu et répond à tout le reste par 415 unsupported_media_type.

EndpointContent-TypeCorps
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-streamoctets bruts ; options dans la query string
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plainle Base64 lui-même

Les corps doivent être en UTF-8 (sauf les octets bruts pour encode). Les champs JSON et les paramètres de requête inconnus sont rejetés avec 400 invalid_body au lieu d’être ignorés : une option mal orthographiée n’échoue jamais en silence. Les options de la query string ne sont lues qu’avec un corps application/octet-stream.

Les réponses sont en JSON (application/json; charset=utf-8), sauf pour decode avec Accept: application/octet-stream, qui renvoie les octets bruts.

CORS et en-têtes

Chaque réponse porte :

Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff

Les requêtes de pré-vérification OPTIONS reçoivent un 204 avec les méthodes autorisées et les en-têtes de requête Content-Type et Accept : l’API peut donc être appelée avec fetch() depuis n’importe quelle page web.

Limites

  • Taille du corps : 1 Mo (1048576 octets). Au-delà, la réponse est 413 too_large.
  • Limite de débit : 20 requêtes par tranche de 10 secondes et par adresse IP sur les chemins sous /v1/. La limite est appliquée par Cloudflare, en amont de l’API. Au-delà, vous recevez le statut 429 avec la réponse propre à Cloudflare, qui n’est pas du JSON et n’a pas d’en-tête CORS : un script de navigateur voit donc une erreur réseau plutôt qu’un corps lisible.
  • Wrap : de 0 à 1000 caractères.

L’API ne conserve aucun état et ne journalise pas le corps des requêtes. Pour les gros fichiers ou les secrets, utilisez un outil local comme la CLI b64.

Erreurs

Les erreurs émises par l’API elle-même sont en JSON, avec un code stable et un message lisible :

{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
StatutCodeQuand
400invalid_bodyJSON mal formé, types de champs incorrects, input manquant, champs ou paramètres de requête inconnus, corps qui n’est pas en UTF-8
400invalid_base64l’entrée de decode n’est pas du Base64 ; le message nomme le problème et sa position
404not_foundchemin inconnu
405method_not_allowedméthode incorrecte pour ce chemin ; l’en-tête Allow liste les bonnes
413too_largecorps de plus de 1 Mo
415unsupported_media_typeun Content-Type que l’endpoint n’accepte pas
429aucunlimite de débit atteinte ; la réponse vient de Cloudflare, pas en JSON
500internal_errorune défaillance inattendue de l’API

Validate signale un Base64 invalide avec le statut 200, car « pas valide » est la réponse à la question qui lui est posée. Voir Valider.

OpenAPI

La description lisible par machine se trouve à l’adresse https://api.base64hub.com/v1/openapi.json. Importez-la dans un client d’API ou un générateur de code pour obtenir des requêtes prêtes à l’emploi pour chaque endpoint.

Mis à jour 22 nov. 2026