Como girar páginas PDF usando Rest API em Python

Girar páginas PDF usando Rest API em Python

Pode haver muitos casos em que você deseja girar páginas de documentos com a orientação errada ou que contenham páginas desorientadas. Por exemplo, se as páginas do documento PDF estiverem de cabeça para baixo, a leitura do documento pode ser bastante difícil. A rotação de páginas é uma ajuda muito útil para melhorar a experiência do leitor. Portanto, uma solução fácil para corrigir a rotação de documentos é usar GroupDocs.Merger Python SDK. Você pode girar todas as páginas ou páginas específicas de um arquivo PDF programaticamente usando o Python SDK. Neste artigo, mostraremos como girar páginas de arquivos PDF permanentemente usando a API REST em Python.

A seguir estão os tópicos que serão discutidos neste artigo:

API de descanso de rotação de páginas PDF e SDK do Python

Para rotacionar arquivos PDF, usarei o Python SDK of GroupDocs.Merger Cloud API. Você pode girar páginas PDF definindo ângulos de rotação como 90, 180 ou 270 graus usando a API GroupDocs.Merger. Também permite dividir, combinar, remover e reorganizar uma única página ou uma coleção de páginas de formatos de documento suportados de Word, Excel, PDF, PowerPoint e HTML etc. Você pode instalar GroupDocs.Merger Cloud SDK em seu aplicativo Python usando o seguinte comando no terminal:

Você pode instalar GroupDocs.Merger Python SDK em seu código de aplicativo Python usando o seguinte comando no console:

pip install groupdocs_merger_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 demonstrado abaixo:

# Importar SDK de fusão do groupdocs
import groupdocs_merger_cloud

# Obtenha app_sid e app_key em https://dashboard.groupdocs.cloud após o registro gratuito.
app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Obter configurações de API de arquivo 
configuration = groupdocs_merger_cloud.Configuration(app_sid, app_key)
configuration.api_base_url = "https://api.groupdocs.cloud"
storage_name = "LocalStorage"

Depois que o Cloud SDK for configurado com sucesso, você poderá usar a enumeração Rotation para selecionar um valor adequado de rotação no sentido horário.

Como girar todas as páginas em um arquivo PDF online em Python

Na seção a seguir, você pode girar permanentemente as páginas do arquivo PDF na nuvem. A rotação é baseada em incrementos de 90 graus. As páginas PDF podem ser giradas em 0/90/180/270 graus. A seguir estão as etapas para girar uma página PDF. 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 certos cenários em que você deseja girar arquivos PDF. Você pode girar todas as páginas do arquivo PDF seguindo as etapas mencionadas abaixo:

  • Primeiramente, crie uma instância da classe PagesApi
  • Em segundo lugar, crie uma instância da classe RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Agora, 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 a classe 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 em Python:

# Como girar todas as páginas do arquivo PDF online em Python
try:
    # Crie uma instância da API de páginas
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    # Defina a rotação da página desejada para 90, 180 ou 270 graus.
    options.mode = "Rotate90"    
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated all pages of PDF file online: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

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

Gire páginas específicas de um documento PDF usando Python

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 segundo lugar, crie uma instância da classe RotateOptions
  • Em seguida, crie uma instância do FileInfo class
  • 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 para Rotate180
  • 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 Python:

# Como girar páginas específicas de um documento PDF usando Python
try:
    # Crie uma instância da API de páginas
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    # Forneça números de página exatos a partir de 1 por meio da coleção de páginas
    options.pages = [1, 7]
    options.mode = "Rotate180"    
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated certain pages of PDF file online: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

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

Girar páginas PDF por intervalo de número de página usando Python

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 da classe RotateOptions
  • Em seguida, crie uma instância do FileInfo class
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Defina a rotação de página desejada como Rotate270
  • Defina os valores do número da página inicial e do número da página final;
  • Em seguida, defina range\mode como EvenPages
  • 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 Python Rest:

# Como girar páginas PDF por intervalo de número de página usando Python
try:
    # Crie uma instância da API de páginas
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    options.mode = "Rotate270"
    options.start_page_number = 1
    options.end_page_number = 10
    # Defina o modo de intervalo como 'AllPages' ou 'OddPages' ou 'EvenPages'
    options.range_mode = "EvenPages" 
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated PDF file pages using Python: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

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

Girar páginas PDF online gratuitamente

Como girar páginas PDF online gratuitamente? Tente a seguinte ferramenta on-line gratuita de rotação de PDF para girar PDF on-line gratuitamente, desenvolvida usando a API acima.

Resumindo

Isso nos leva à conclusão deste artigo. Você aprendeu sobre esses materiais neste artigo:

  • como girar todas as páginas do documento PDF usando Python;
  • como girar páginas específicas de um arquivo PDF usando Python;
  • como girar páginas PDF por intervalo de páginas em Python;

Além disso, você pode aprender mais sobre GroupDocs.Merge Cloud API usando a documentação. Também temos uma seção Referência de API que permite visualizar e interagir com nossas APIs de nuvem diretamente pelo navegador. Para outros tópicos interessantes, por favor, fique em contato para atualizações regulares. Sugerimos que você siga nosso Guia de primeiros passos.

Por fim, groupdocs.cloud está escrevendo novos artigos de blog sobre diferentes soluções de formato de arquivo usando a API REST. Fique atento para as últimas atualizações.

Faça uma pergunta

Se você tiver alguma dúvida sobre o rotador de página PDF on-line, sinta-se à vontade para nos perguntar no Fórum de suporte gratuito

perguntas frequentes

Como girar documentos PDF permanentemente em Python?

Visite este link para aprender o trecho de código Python sobre como girar o arquivo PDF permanentemente em Python.

Como girar o arquivo PDF online usando a API REST?

Crie uma instância de PagesApi, defina os valores de RotateOptions e invoque o método pagesApi.rotate() com RotateRequest para girar o PDF e salvá-lo online em Python.

Como instalar a biblioteca de download gratuito do rotador de página PDF?

Você pode instalar o rotador de PDF biblioteca Python para download gratuito para girar o PDF no Windows programaticamente.

Como faço para girar páginas PDF no Windows?

Visite este link para baixar o rotador de páginas em PDF gratuitamente. Este software off-line é usado para executar diferentes operações de formato de arquivo, incluindo rotação de documentos no Windows, usando um único clique.

Veja também