Separar pdf API

Separar pdf API, PdfSplit conecta el trabajo a tu propia app: envías el archivo, consultas el estado del trabajo y descargas el resultado. Los endpoints se ejecutan en el servidor; no interviene ningún navegador.

Inicio rápido

Crea una clave en la sección API para desarrolladores de tu cuenta; la clave en texto sin formato solo se muestra al momento de crearla.
Envía la solicitud a https://api.pixepi.com con el encabezado Authorization: Bearer <key>.
Consulta el trabajo devuelto con GET https://api.pixepi.com/api/v1/jobs/{id}; una vez que el estado sea done, descarga el resultado desde download_url.

Ejemplo de solicitud

curl -X POST "https://api.pixepi.com/api/v1/apps/pdfsplit/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "[email protected]" \
  -F "options[mode]=pages" \
  -F "options[page_range]=1-3"

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/jobs/42"

Endpoints de esta herramienta

Método	Ruta	Qué hace
`POST`	`/run`	Ejecuta la herramienta, inicia un trabajo y devuelve el resultado.

Opciones

Las opciones se envían como options[<field>]; si un campo se deja vacío, se usa su valor predeterminado.

Campo	Valores	Por defecto
`options[mode]` Modo de división	pages · range · chunks	`pages`
`options[page_range]` Rangos de páginas		`1-3`
`options[chunk_size]` Tamaño del bloque	1–500	`5`
`options[merge_output]` Unir los rangos en un solo PDF	activado · desactivado	`desactivado`

Endpoints compartidos

Método	Ruta	Qué hace
`GET`	`/api/v1/apps`	Catálogo de la API
`GET`	`/api/v1/apps/pdfsplit`	Contrato de la herramienta
`GET`	`/api/v1/jobs/{id}`	Estado del trabajo
`GET`	`/api/v1/jobs/{id}/download`	Descargar el resultado del trabajo
`GET`	`/api/v1/usage`	Resumen de uso
`GET`	`/api/v1/openapi.json`	Documento OpenAPI 3.1

Límites

Como máximo 100 MB por archivo.
La información del plan y la cuota está vinculada a tu cuenta; consulta el estado actual con GET /api/v1/usage.

Códigos de error

Código	Significado
`unauthorized`	Falta la clave API o no es válida.
`forbidden`	Esta operación no está permitida con esta clave.
`not_found`	Herramienta, tarea o registro no encontrado (404 también para acceso entre cuentas).
`invalid_input`	Error de validación en los datos de entrada (campo ausente o incorrecto, fecha no válida, etc.).
`invalid_request`	La solicitud tiene un formato incorrecto.
`too_large`	El tamaño del archivo o del cuerpo supera el límite.
`unsupported_media`	El tipo de archivo no es compatible.
`not_supported`	Esta herramienta no se puede ejecutar en este endpoint (app con estado).
`not_ready`	La tarea aún no ha terminado.
`expired`	El resultado ha caducado.
`no_output`	No hay ningún resultado disponible para descargar.
`invalid_path`	Ruta de salida no válida.
`quota_exceeded`	Límite de cuota o de frecuencia superado.
`rate_limited`	Demasiadas solicitudes en poco tiempo; espera un poco e inténtalo de nuevo.
`csrf`	Error en la verificación del formulario del navegador (la API externa usa claves).
`conflict`	La operación entra en conflicto con el estado actual.
`unavailable`	La herramienta no está disponible temporalmente.
`internal_error`	Error inesperado del servidor.

Documentos

Preguntas frecuentes

¿Dónde consigo una clave de API?

Crea una clave en la sección Developer API de tu cuenta; la clave solo se muestra una vez, al momento de crearla.

¿Cómo se envía una solicitud?

Los endpoints se ejecutan en https://api.pixepi.com; cada solicitud incluye el encabezado "Authorization: Bearer <key>".

¿Qué archivos admite la API de PdfSplit?

Tipos admitidos: PDF. El límite es de 100 MB por archivo; las opciones son las mismas que en la página de la herramienta.

¿Cómo se interpreta una respuesta de error?

El cuerpo del error contiene los campos {ok:false, error, code, request_id}; los valores de code están en la tabla de códigos de error.