Girar páginas PDF

---

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