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éthode | Chemin | Rôle |
|---|---|---|
POST | /v1/encode | texte ou octets bruts vers Base64 |
POST | /v1/decode | Base64 vers texte, hexadécimal ou octets bruts |
POST | /v1/validate | vérifier du Base64 et le décrire |
GET | /v1/health | état et version |
GET | /v1/openapi.json | description 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.
| Endpoint | Content-Type | Corps |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | octets bruts ; options dans la query string |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/plain | le 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 statut429avec 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"}}
| Statut | Code | Quand |
|---|---|---|
| 400 | invalid_body | JSON mal formé, types de champs incorrects, input manquant, champs ou paramètres de requête inconnus, corps qui n’est pas en UTF-8 |
| 400 | invalid_base64 | l’entrée de decode n’est pas du Base64 ; le message nomme le problème et sa position |
| 404 | not_found | chemin inconnu |
| 405 | method_not_allowed | méthode incorrecte pour ce chemin ; l’en-tête Allow liste les bonnes |
| 413 | too_large | corps de plus de 1 Mo |
| 415 | unsupported_media_type | un Content-Type que l’endpoint n’accepte pas |
| 429 | aucun | limite de débit atteinte ; la réponse vient de Cloudflare, pas en JSON |
| 500 | internal_error | une 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