Dividir PDF en múltiples ficheros

Si encuentras algún problema con el API, por favor comunícalo en GitHub


4.4 Como dividir ficheros pdf usando nuestra API


URL

Para dividir PDF's usando nuestra API Rest es necesario realizar una llamada POST a la siguiente url:

https://getoutpdf.com/api/tool/split-pdf


Parámetros GET

Nuestra API Rest no dispone de operaciones a través de parámetros GET


Parámetros POST

  • api_keyApi key generada para tu licencia. Puedes ver tu api key en
    (string, required)
  • pdf_inFichero PDF de origen codificado en base64
    (string, required)
  • splitNumero de páginas de cada parte dividida.
    (integer, optional)
  • start_pageLa página para empezar
    (integer, optional)
  • end_pageLa página para terminar
    (integer, optional)

Algunos ejemplos
  • Piezas 0, Inicio 0, Fin 0 => dividirá el pdf página por página
  • Piezas 2, Inicio 0, Fin 0 => dividirá el pdf en partes de 2 páginas cada una (excepto la última si contiene solo 1 página).
  • Piezas 0, Inicio 5, Fin 0 => proporcionará un pdf que contiene todas las páginas de la fuente pdf a partir de la página 5
  • Piezas 0, Inicio 5, Fin 10 => proporcionará un pdf que contiene todas las páginas de la 5 a la 10 de la fuente pdf
  • Piezas 2, Inicio 5, Fin 10 => proporcionará 3 pdf's que contienen todas las páginas de la 5 a la 10 de la fuente pdf con 2 páginas cada uno

Puedes hacer una llamada POST, utilizando la cabecera html application/x-www-form-urlencoded, con los parámetros anteriormente descritos.

O también puedes enviar los parámetros a través del formato JSON, utilizando la cabecera html application/json:

{
    "api_key" : "...",          // string, required
    "pdf_in" : "...",           // string, required
    "split" : 1,                // integer, optional, default: 1
    "start_page" : 2,           // integer, optional, default: 1
    "end_page" : 3              // integer, optional
}

Ejemplo

{
    "api_key" : "64b5d1054b69e676b9984d8406c5209a6ba78...",
    "pdf_in" : "JVBERi0xLjQNJeLjz9MNCjYgMCBvYmo8PC9I...",
    "split" : 1,
    "start_page" : 2,
    "end_page" : 3
}

Respuesta

Si la operación se ha realizado correctamente la respuesta es un JSON con la siguiente estructura:

{
    "api_key": "...",                   // string - Api key utilizada para tu licencia
    "pdf_base64": ["...", "...", ...],  // array(string) - Array de ficheros PDF codificados en base64
    "tokens_used": "...",               // integer - Créditos utilizados para la operación
    "tokens_left": "..."                // integer - Créditos restantes
}

Errores

Si se produce un error en el envío de parámetros, la respuesta será un JSON con la siguiente estructura:

{
    "errors": {
        "param1": [     // string - Nombre del parámetro que ha generado el error
            "message"   // string - Descripción del error
        ],
        "param2": [
            "message"
        ],
        ...
        "paramN": [
            "message"
        ]
    }
}

Si se produce un error en la operación, la respuesta será un JSON con la siguiente estructura:

{
    "errors": [
        "message1",
        "message2",
        ...
        "messageN"
    ]
}