Cómo enviar un PDF a una API en Base64
Una API de facturación electrónica, firma electrónica o envíos quiere el documento en un campo JSON. Así conviertes el PDF en el texto correcto, lo compruebas y evitas los errores que hacen fallar la petición.
Por Metin Ersoy · Actualizado el 10 de noviembre de 2026
Lo que suele esperar la API
La mayoría de las API de documentos describen un cuerpo JSON con un campo llamado content, file, data o document. Su valor es el código Base64 del PDF, a menudo acompañado de un nombre de archivo y un tipo:
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Antes de escribir código, busca tres cosas en la documentación: el nombre del campo, si hace falta un prefijo data: (normalmente no) y el límite de tamaño.
1. Convierte el PDF a Base64
La forma más rápida de obtener un valor de prueba es PDF a Base64. Elige el PDF, selecciona Solo el código Base64 y copia el resultado. Si prefieres partir de un cuerpo de petición completo, elige JSON: agrega por ti el nombre del archivo y el tipo. El PDF se codifica en tu navegador y no se sube, algo importante cuando el documento de prueba es una factura real.
Revisa el resultado: debe empezar por JVBERi0, no tener espacios y contener solo letras, números, + y /, salvo uno o dos signos = al final.
2. Envíalo desde tu código
El mismo paso en tres lenguajes habituales. Cada ejemplo lee el archivo, lo codifica y envía el JSON:
# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
En macOS, la línea de curl usa base64 -i invoice.pdf en lugar de -w 0. La dirección y los nombres de los campos son ejemplos; usa los que indique la documentación de tu servicio.
3. Comprueba el viaje de ida y vuelta
Si el servicio devuelve el documento o una copia guardada en Base64, pega esa respuesta en Base64 a PDF. Ver la primera página y el número de páginas es la forma más rápida de comprobar que no se perdió nada por el camino. Los pasos detallados para hacerlo a la inversa están en Cómo guardar una cadena Base64 como archivo PDF.
Errores frecuentes
| Síntoma | Causa probable | Solución |
|---|---|---|
| "Invalid Base64" | Saltos de línea (líneas de 76 caracteres) o un prefijo data: | Envía el código sin prefijo en una sola línea |
| "Payload too large" (413) | El PDF es demasiado grande una vez codificado | Redúcelo con Comprimir PDF |
| El PDF se abre en blanco o dañado | La cadena se cortó | Vuelve a codificarlo y envía el valor completo |
| Los nombres con tildes se ven mal | El nombre del archivo se envió con una codificación incorrecta | Mantén el cuerpo JSON en UTF-8 |
¿Quieres probarlo? Es gratis y tu archivo se queda en tu dispositivo.
Abrir PDF a Base64