Unir PDF's en uno

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


4.3 Como combinar ficheros pdf usando nuestra API


URL

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

https://getoutpdf.com/api/tool/merge-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_inArray de string codificados en base64
    (array(string), required)

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" : [                // array (string), required
            "",
            "",
            "",
            ...
        ]
}

Ejemplo

{
    "api_key" : "64b5d1054b69e676b9984d8406c5209a6ba78...",
    "pdf_in" : [
            "JVBERi0xLjQNJeLjz9MNCjYgMCBvYmo8PC9I...",
            "JVBERi0xLjQKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMS...",
            "JVBERi0xLjQNJeLjz9MNCjYgMCBvYmo8PC9I..."
        ]
}

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": "...",    // string - Fichero PDF codificado 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"
    ]
}