Como girar páginas PDF usando a API Rest no Node.js

Como girar páginas PDF usando a API Rest no Node.js

Neste artigo, demonstraremos os cenários relacionados à rotação em arquivos PDF na definição de graus. Você pode girar todas as páginas do PDF de uma só vez ou páginas específicas do PDF em qualquer direção permanentemente de acordo com seus requisitos. Além disso, você pode escolher o ângulo para girar as páginas PDF como rotação de 90 graus ou girar páginas PDF em 180 graus. Neste artigo, aprenderemos como girar páginas PDF usando a API REST no Node.js.

Os seguintes tópicos serão abordados neste artigo:

API Rest de rotação de páginas PDF e SDK Node.js

Para girar as páginas do PDF Adobe Acrobat, usarei a API Node.js SDK do GroupDocs.Merger Cloud. É uma biblioteca de download gratuito de rotação de página PDF online. Ele permite que você divida, combine, extraia, remova e reorganize uma única página ou uma coleção de páginas de formatos de documento suportados de Word, Excel, PowerPoint, Desenhos do Visio, PDF e HTML.

Você pode instalar a nuvem GroupDocs.Merger para girar páginas PDF em seu aplicativo Node.js usando o seguinte comando no console:

npm install groupdocs-conversion-cloud

Obtenha seu ID de cliente e Segredo do cliente no painel antes de começar a seguir as etapas e os exemplos de código disponíveis. Depois de ter seu ID e segredo, adicione o código conforme mostrado abaixo:

# Importe o SDK do Node.js em seu aplicativo de nó de http://api.groupdocs.cloud
global.groupdocs_merger_cloud = require("groupdocs-merger-cloud");
global.fs = require("fs");

// obtenha clientId e clientSecret em https://dashboard.groupdocs.cloud (é necessário registro gratuito).
global.clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
global.clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
global.myStorage = "test-internal-storage";
const config = new groupdocs_merger_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";

Girar todas as páginas de um documento PDF usando Node.js

Você pode girar páginas PDF em um documento PDF programaticamente na nuvem seguindo as etapas abaixo. Primeiro, carregue o arquivo PDF para a nuvem e o arquivo PDF carregado estará disponível na seção de arquivos do painel na nuvem. Pode haver muitos casos de uso em que você precisa girar arquivos PDF. Você pode girar todas as páginas de um arquivo PDF seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Em seguida, defina a rotação de página desejada como Rotate90
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código a seguir mostra como girar todas as páginas de um arquivo PDF usando a API REST no Node.js:

// Como girar todas as páginas de um documento PDF usando Node.js
const rotate = async () => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // criar opções de rotação de PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate90;

  try {
    // Criar solicitação de rotação de documento PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

Por fim, o exemplo de código acima salvará o arquivo PDF atualizado na nuvem. Você pode baixar o arquivo de upload usando o snippet de código.

Girar páginas específicas do arquivo PDF usando o SDK Node.js

A rotação em um documento PDF é aplicada no nível da página. Portanto, você também pode girar páginas específicas do arquivo PDF de acordo com seus requisitos. Você só precisa escolher o número da página em que deseja aplicar a rotação. As etapas abaixo explicam como girar determinadas páginas do arquivo PDF:

  • Primeiro, crie uma instância da PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Atribua os números de página exatos usando a coleção de páginas
  • Defina a rotação de página desejada como Rotate90, Rotate180 ou Rotate270
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código a seguir detalha como girar páginas específicas ou determinadas em um documento PDF usando Node.js:

// Como girar páginas específicas de um arquivo PDF usando o Node.js SDK

const rotate = async () => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // criar opções de rotação de PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.pages = [2, 4];
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate90;

  try {
    // Criar solicitação de rotação de documento PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

Por fim, o exemplo de código acima salvará o arquivo PDF de saída na nuvem.

Girar páginas PDF por número de página usando o SDK Node.js

Você também pode girar páginas PDF por número de página. Você precisa fornecer o número da página inicial e o número da página final para aplicar a rotação. As etapas abaixo explicam como girar páginas PDF por números de página de um arquivo PDF:

  • Primeiro, crie uma instância da PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Defina os valores do número da página inicial e do número da página final;
  • Defina a rotação de página desejada como Rotate270
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código abaixo mostra como girar páginas em um documento PDF fornecendo números de página usando a API Node.js Rest:

// Como girar páginas PDF por número de página usando o Node.js SDK
const rotate = async () => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // criar opções de rotação de PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.startPageNumber = 1;
  options.endPageNumber = 10;
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate270;

  try {
    // Criar solicitação de rotação de documento PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

O exemplo de código acima salvará o documento PDF de saída na nuvem.

Girar páginas PDF on-line gratuitamente

Tente a seguinte ferramenta on-line gratuita para girar páginas de documentos PDF, desenvolvida usando a API acima.

Resumindo

Neste artigo, você aprendeu:

  • como girar todas as páginas de um documento PDF online usando Node.js;
  • gire programaticamente certas páginas de um arquivo PDF usando Node.js;
  • como girar páginas PDF por número de página e modo de intervalo usando Node.js;

Além disso, você pode aprender mais sobre GroupDocs.Merge Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Além disso, groupdocs.cloud está escrevendo novas postagens de blog sobre outros tópicos interessantes. Portanto, por favor, fique em contato para atualizações regulares.

Faça uma pergunta

Se você tiver alguma dúvida sobre a rotação de páginas PDF, sinta-se à vontade para nos perguntar no Fórum de suporte gratuito

Veja também