Adicionar ou remover páginas PDF usando a API REST do Python

No mundo digital de hoje, os documentos PDF se tornaram essenciais para compartilhar e armazenar informações. No entanto, há momentos em que você pode precisar fazer modificações em seus arquivos PDF, como adicionar ou remover páginas. Se você deseja inserir páginas adicionais para fornecer conteúdo adicional, excluir páginas desnecessárias para agilizar seu documento ou reorganizar a ordem das páginas para melhorar o fluxo, ter a capacidade de executar essas operações é crucial. Neste artigo, exploraremos como adicionar e remover páginas PDF usando o Python Cloud SDK, fornecendo a você o conhecimento e as ferramentas para gerenciar e personalizar seus documentos PDF de forma eficiente, de acordo com suas necessidades específicas.

• SDK de processamento de PDF
• Adicionar páginas ao PDF usando Python
• Excluir páginas de PDF usando Python
• Adicionar páginas PDF usando o comando cURL
• Excluir páginas PDF usando o comando cURL

SDK de processamento de PDF

Aspose.PDF Cloud é uma API baseada em REST que fornece os recursos para executar a criação e processamento de PDF. Não é necessária a instalação do Adobe Acrobat ou de outro software e você pode executar todas as operações na nuvem. De acordo com o escopo deste artigo, usaremos o Aspose.PDF Cloud SDK para Python para processamento de arquivos PDF. Este SDK é um wrapper em torno da API REST e você pode baixá-lo gratuitamente do repositório PIP e GitHub. Portanto, execute o seguinte comando no terminal/prompt de comando para instalar a versão mais recente do SDK.

pip install asposepdfcloud

Estúdio Visual MS

Você também pode adicionar diretamente a referência no seu projeto Python dentro do projeto do Visual Studio. Pesquise asposepdfcloud como um pacote na janela do ambiente Python. Siga as etapas numeradas na imagem abaixo para concluir o processo de instalação.

Como nossas APIs são acessíveis apenas a pessoas autorizadas, você também precisa criar uma conta no cloud dashboard(caso não tenha uma conta existente).Use sua conta do GitHub ou Google para fazer login ou clique no botão create a new account e forneça as informações necessárias. Em seguida, faça login no painel e expanda a seção Applications sobre o painel. Agora role para baixo em direção à seção Client Credentials para obter seus detalhes personalizados de Client ID e Client Secret.

Adicionar páginas ao PDF usando Python

Siga os passos abaixo para adicionar páginas ao documento PDF usando o snippet de código Python:

• Primeiro, precisamos criar uma instância da classe ApiClient e fornecer o ID do cliente e o segredo do cliente como argumentos.
• Em segundo lugar, crie uma instância da classe PdfApi que recebe o objeto ApiClient como argumento de entrada.
• Agora chame o método putaddnewpage(..) da classe PdfApi, que adiciona uma página em branco no final do documento. O PDF resultante é então salvo no armazenamento em nuvem.

def addPage():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # crie uma instância PdfApi enquanto passa PdfApiClient como argumento
        pdf_api = PdfApi(pdf_api_client)

        #source image file
        input_file = 'URL2PDF.pdf'
        
        # adicionar página no final do documento PDF
        response = pdf_api.put_add_new_page(name = input_file)
        print(response)

        # imprimir mensagem no console (opcional)
        print('Blank page successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

Excluir páginas de PDF usando Python

A API também fornece a capacidade de excluir uma página específica do documento PDF. Então, para cumprir esse requisito, siga as instruções fornecidas abaixo.

• Primeiro, crie uma instância da classe ApiClient e forneça o ID do cliente e o segredo do cliente como argumentos.
• Em segundo lugar, crie um objeto da classe PdfApi que receba o objeto ApiClient como argumento de entrada.
• Por fim, chame o método deletepage(…) para remover a página específica do documento PDF.

def deletePage():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # crie uma instância PdfApi enquanto passa PdfApiClient como argumento
        pdf_api = PdfApi(pdf_api_client)

        #source image file
        input_file = 'URL2PDF.pdf'
        
        # excluir segunda página do documento PDF
        response = pdf_api.delete_page(name = input_file, page_number=2)
        print(response)

        # imprimir mensagem no console (opcional)
        print('Page successfully deleted from PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

Adicionar páginas PDF usando o comando cURL

Os comandos cURL fornecem uma abordagem conveniente para acessar APIs REST por meio do terminal de linha de comando. Como o Aspose.PDF Cloud é desenvolvido conforme a arquitetura REST, também podemos usar os comandos cURL para atender aos nossos requisitos. No entanto, como as APIs são acessíveis apenas a usuários autorizados, primeiro precisamos gerar um JSON Web Token (JWT) com base em nossas credenciais de cliente. Portanto, execute o seguinte comando para gerar o token de acesso JWT.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Execute o seguinte comando para adicionar uma página em branco no final do documento PDF.

curl -v -X PUT "https://api.aspose.cloud/v3.0/pdf/URL2PDF.pdf/pages" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-d{}

Excluir páginas PDF usando o comando cURL

Também podemos remover a página PDF usando o comando cURL. Então, execute o seguinte comando para excluir a 2ª página do arquivo PDF.

curl -v -X DELETE "https://api.aspose.cloud/v3.0/pdf/URL2PDF.pdf/pages/2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-d{}

Conclusão

Neste artigo, discutimos os detalhes e as etapas sobre como podemos adicionar ou remover páginas de documentos PDF usando a API REST. Exploramos as opções para cumprir esse requisito usando o snippet de código Python ou os comandos cURL. O código-fonte completo do Apsose.PDF Cloud SDK para Python está disponível para download no GitHub. Por fim, caso você encontre algum problema ao usar a API ou tenha alguma dúvida relacionada, sinta-se à vontade para entrar em contato conosco pelo fórum de suporte gratuito ao produto.

Artigos relacionados

Recomendamos também que você visite os seguintes links para saber mais sobre:

• PDF para imagem – Converta PDF para JPEG em Python
• Extrair imagens de PDF em Python
• Extrair texto de PDF em Python
• PDF para PPTX – Converta PDF para PowerPoint em Python
• JPEG para PDF – Converta JPEG para PDF em Python