Rotar un PDF
Los escáneres alimentan páginas en horizontal, los teléfonos fotografían documentos en cualquier orientación, y el PDF que termina en su escritorio le obliga a torcer el cuello para leerlo. Este endpoint lo endereza de forma programática — elige un ángulo, elige qué páginas, listo.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema de las páginas de lado es más común de lo que debería
Cualquiera que haya escaneado una pila de papeles con orientaciones mezcladas conoce el resultado: la mitad de las páginas se leen bien, la otra mitad exige inclinar la cabeza 90 grados. Los escáneres multifunción, las pasarelas de fax a PDF y las apps de captura móvil producen esta inconsistencia todo el tiempo, y corregirla a mano página por página en un visor de escritorio no escala más allá de un puñado de documentos. Este endpoint existe precisamente para ese paso de limpieza, hecho en volumen, sin que nadie toque un mouse.
Qué cambia realmente al rotar
Rotar una página de PDF ajusta su orientación de visualización — el contenido en sí no se toca, pero la página se muestra girada según el ángulo que indique: 90, 180 o 270 grados, en sentido horario. Esa distinción importa porque significa que la operación es sin pérdida e instantánea frente a volver a escanear: no hay que rehacer el OCR, no se pierde calidad, no se re-maqueta nada. Puede rotar todo el documento de manera uniforme, o apuntar a páginas específicas cuando solo algunas llegaron de lado.
Cómo funciona la llamada
Envía por POST el PDF y el ángulo de rotación (más una selección opcional de páginas) a /pdf/rotate. Como toda tarea en esta API, se ejecuta de forma asíncrona: recibe un task_id de inmediato y el archivo corregido llega a su webhook firmado, o mediante un enlace firmado que permanece activo por 24 horas si prefiere recuperarlo con su propio ritmo.
Dónde encaja en un flujo de trabajo
Casi nunca se usa de forma aislada — es el segundo paso silencioso después de un flujo de escaneo o fax a PDF, ejecutado automáticamente antes de archivar, aplicar OCR o reenviar el documento por correo. Encadenarlo primero con una verificación de PDF escaneado le permite rotar solo lo que realmente lo necesita, en vez de rotar a ciegas cada archivo entrante.
Lo que cuesta y lo que no le cuesta
Es una tarifa plana de $0.002 por solicitud sin importar el número de páginas, porque rotar es un cambio estructural ligero y no una operación de renderizado pesada. Si la tarea falla tras sus reintentos automáticos, no se le cobra — el precio refleja el trabajo realmente hecho, no una estimación.
Qué puede hacer con ella
Limpieza de lotes de escáner
Un escáner de oficina deposita páginas con orientaciones mezcladas en una carpeta; un job automático rota cada página de lado a 0 grados antes de archivarla.
Recepción de fax por correo
Los faxes entrantes se convierten a PDF al revés casi la mitad de las veces; este endpoint corrige la orientación automáticamente antes de enviarlos a la bandeja correcta.
Captura de documentos desde el celular
Una app de campo permite al personal fotografiar papeles con el teléfono; la rotación del lado del servidor corrige la orientación que haya guardado la cámara.
Preprocesamiento antes del OCR
La precisión del OCR cae mucho con texto rotado; rotar primero garantiza que el paso de reconocimiento reciba páginas ya derechas.
Preguntas frecuentes
¿Cómo roto un PDF con la API?
Envíe una solicitud POST a /pdf/rotate con el archivo y el ángulo deseado — 90, 180 o 270 grados — y recibe el PDF corregido por webhook o enlace firmado.
¿Puedo rotar solo algunas páginas y no todo el documento?
Sí, puede indicar páginas específicas por número y dejar el resto del documento en su orientación original.
¿Rotar reduce la calidad o vuelve a ejecutar el OCR?
No. Solo cambia el metadato de orientación de visualización de la página; el contenido, la resolución y cualquier capa de texto existente quedan exactamente igual.
¿Hay una forma gratuita de probar la API de rotar PDF?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Puedo rotar en sentido antihorario?
Especifique 270 grados para un giro de un cuarto en sentido antihorario, o 90 para horario; ambos se manejan como valores de ángulo estándar.
¿Qué pasa si el PDF ya está bien orientado?
Puede simplemente omitir la llamada, o combinar este endpoint con una verificación de orientación previa para rotar solo los archivos que de verdad lo necesiten.
¿Qué tan rápido rota en volumen?
Al ser una operación estructural ligera y no un trabajo de renderizado, procesa rápido incluso en lotes grandes enviados como tareas separadas.
¿Qué pasa si una tarea de rotación falla?
Reintenta automáticamente hasta tres veces; si aun así no logra completarse, recibe un error claro y nunca se le cobra por el intento fallido.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/rotate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"https://ejemplo.com/documento.pdf"}'const res = await fetch("https://api.kit.forhosting.com/pdf/rotate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/rotate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/rotate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/rotate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.rotate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |