Le firme elettroniche sono semplici come un nome inserito nei documenti elettronici. Questi sono sempre più utilizzati nell’e-commerce e nei depositi normativi. Le firme elettroniche rappresentano i dati nella forma codificata visivamente utilizzata dal firmatario per firmare elettronicamente i documenti. In qualità di sviluppatore Python, puoi modificare elettronicamente le firme nei tuoi documenti PDF firmati in modo programmatico sul cloud. Questo articolo si concentrerà su come modificare le firme nei documenti PDF firmati utilizzando un’API REST in Python.
In questo articolo saranno trattati i seguenti argomenti:
- API REST della firma del documento e Python SDK
- Modifica le firme nei documenti PDF firmati utilizzando un’API REST
- Cerca e sostituisci firme elettroniche usando Python
API REST della firma del documento e Python SDK
Per modificare le firme elettroniche in un documento PDF, utilizzerò l’API Python SDK of GroupDocs.Signature Cloud. Ti consente di proteggere elettronicamente documenti e immagini per i formati di file supportati applicando testo, timbro, codice QR, codice a barre, immagine e firme digitali. Puoi anche creare, verificare, eliminare e cercare facilmente diversi tipi di firme. Fornisce inoltre SDK .NET, Java, PHP, Android, Ruby e Node.js come membri della famiglia di firme del documento per l’API Cloud.
Puoi installare GroupDocs.Signature Cloud nel tuo progetto Python con pip (package installer for python) utilizzando il seguente comando nella console:
pip install groupdocs_signature_cloud
Si prega di ottenere l’ID cliente e il segreto cliente dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Aggiungi il tuo ID e segreto nel codice come mostrato di seguito:
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Modifica le firme nei documenti PDF firmati utilizzando un’API REST in Python
È possibile modificare le firme nei documenti PDF firmati seguendo i semplici passaggi indicati di seguito:
- Carica i file PDF firmati nel Cloud
- Aggiorna le firme nei documenti PDF firmati utilizzando Python
- Scarica il file risultante
Carica il documento
Prima di tutto, carica il documento PDF firmato sul Cloud utilizzando il codice di esempio riportato di seguito:
# inizializzazione dell'API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# caricare file di esempio
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)
Di conseguenza, il file PDF caricato (signed.pdf) sarà disponibile nella sezione file della dashboard sul cloud.
Aggiorna le firme nei documenti PDF firmati utilizzando Python
È possibile aggiornare le firme in un file PDF firmato a livello di programmazione seguendo i passaggi indicati di seguito.
- Crea un’istanza di SignApi
- Imposta il percorso del file PDF firmato
- Cerca il codice QR fornendo SearchQRCodeOptions e SearchSettings
- Crea SearchSignatureRequest
- Ottieni risultati chiamando il metodo SignApi.search\signatures().
- Definisci opzioni di aggiornamento
- Imposta le impostazioni di aggiornamento
- Assegna UpdateOptions a UpdateSettings
- Crea UpdateSignaturesRequest
- Ottieni risultati chiamando il metodo SignApi.update\signatures().
Il seguente frammento di codice mostra come aggiornare le firme del codice QR in un documento PDF firmato utilizzando un’API REST.
# inizializzazione dell'API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# percorso del documento firmato
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# cerca codice qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# aggiornare il codice qr
opts = groupdocs_signature_cloud.UpdateOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
opts.left = 450
opts.top = 600
opts.width = 90
opts.height = 90
opts.is_signature = True
settings = groupdocs_signature_cloud.UpdateSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.UpdateSignaturesRequest(settings)
response = api.update_signatures(request)
Aggiorna le firme nel documento PDF firmato utilizzando Python
Scarica il file firmato
L’esempio di codice precedente salverà il file PDF aggiornato sul cloud che può essere scaricato utilizzando il seguente esempio di codice:
# inizializzazione dell'API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)
# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")
Cerca e sostituisci firme elettroniche usando Python
È possibile cercare e sostituire le firme in un documento PDF firmato a livello di programmazione seguendo i passaggi indicati di seguito.
- Crea un’istanza di SignApi
- Imposta il percorso del file PDF firmato
- Cerca codice QR
- Definire SearchQRCodeOptions e SearchSettings
- Crea SearchSignatureRequest
- Ottieni risultati chiamando il metodo SignApi.search\signatures().
- Elimina il codice QR cercato
- Definire DeleteOptions e DeleteSettings
- Crea DeleteSignatureRequest
- Ottieni risultati chiamando il metodo SignApi.delete\signatures().
- Firma con codice a barre
- Definisci Opzioni codice a barre
- Imposta la dimensione e la posizione del codice a barre
- Definisci impostazioni segno
- Assegna SignBarcodeOptions e SaveOptions a SignSettings
- Crea CreateSignaturesRequest
- Ottieni risultati chiamando il metodo SignApi.create\signatures().
Il seguente frammento di codice mostra come cercare la firma del codice QR e sostituirla con una firma del codice a barre in un documento PDF firmato utilizzando un’API REST. Si prega di seguire i passaggi menzionati in precedenza per scaricare il file aggiornato.
# inizializzazione dell'API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# percorso documento firmato codice qr
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# cerca codice qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# eliminare il codice qr
opts = groupdocs_signature_cloud.DeleteOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
settings = groupdocs_signature_cloud.DeleteSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.DeleteSignaturesRequest(settings)
response = api.delete_signatures(request)
# firmare con codice a barre
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'
# impostare la posizione della firma del codice a barre su una pagina
opts.left = 250
opts.top = 0
opts.width = 300
opts.height = 90
opts.location_measure_type = "Pixels"
opts.size_measure_type = "Pixels"
opts.stretch = "None"
opts.rotation_angle = 0
opts.horizontal_alignment = "None"
opts.vertical_alignment = "None"
opts.margin = groupdocs_signature_cloud.Padding()
opts.margin.all = 5
opts.margin_measure_type = "Pixels"
opts.inner_margins = groupdocs_signature_cloud.Padding()
opts.inner_margins.all = 2
opts.page = 1
settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "Output\\signedBarCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Cerca e sostituisci le firme nel documento PDF firmato utilizzando Python
Prova in linea
Prova il seguente strumento di firma PDF online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/signature/pdf
Conclusione
In questo articolo, hai imparato come aggiornare le firme nei documenti PDF firmati. Hai anche imparato a cercare e sostituire le firme nei documenti PDF firmati sul cloud. Questo articolo spiega anche come caricare a livello di codice un file PDF nel cloud e quindi scaricare il file firmato dal cloud. Puoi saperne di più su GroupDocs.Signature Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di qualsiasi ambiguità, non esitate a contattarci sul forum.