Girar páginas PDF

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


4.6 Cómo girar páginas de un pdf usando nuestra API


URL

Para girar páginas de un PDF usando nuestra API Rest es necesario realizar una llamada POST a la siguiente url:

https://getoutpdf.com/api/tool/rotate-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)
  • angleÁngulo de rotación. El ángulo de rotación también depende de la dirección. Si seleccionas 90º y dirección derecha es lo mismo que seleccionar 270º y dirección izquierda
    (integer, optional, values: 0 | 90 | 180 | 270, default: 0
  • directionDirección de rotación. Puedes especificar la dirección de rotación
    (string, optional, values: left | right, default: left)
  • pagesPaginas a girar. En este campo puedes seleccionar las páginas a girar (número de página separado por comma). Si dejas el campo vacio se girarán todas las páginas.
    (string, optional, page number separated by comma)

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
    "angle" : 90,               // integer, optional, values: 0 | 90 | 180 | 270, default: 0
    "direction" : "left",       // string, optional, values: left | right, default: left
    "pages" : "1,3"             // string, optional, default: "" (all pages rotated)
}

Ejemplo

{
    "api_key" : "64b5d1054b69e676b9984d8406c5209a6ba78...",
    "pdf_in" : "JVBERi0xLjQNJeLjz9MNCjYgMCBvYmo8PC9I...",
    "angle" : 90,
    "direction" : "right",
    "pages" : "1,3,4,6"
}

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"
    ]
}