Puoi firmare elettronicamente i tuoi documenti PDF con il codice QR in modo programmatico sul cloud. Le firme digitali forniscono lo stesso valore legale di una firma autografa purché rispetti i requisiti del regolamento specifico. Questo articolo si concentrerà su come firmare documenti PDF con codice QR utilizzando un’API REST in Python.
In questo articolo saranno trattati i seguenti argomenti:
- API REST della firma del documento e Python SDK
- Firma documenti PDF utilizzando un’API REST
- Verifica le firme elettroniche utilizzando Python
API REST della firma del documento e Python SDK
Per la firma elettronica PDF, utilizzerò l’API Python SDK of GroupDocs.Signature Cloud. Ti consente di creare, verificare e cercare diversi tipi di firme in documenti portatili o semplici, fogli di calcolo, presentazioni e immagini per i formati di file supportati. 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 = ""
Firma documenti PDF utilizzando un’API REST in Python
Puoi firmare documenti PDF con QR Code seguendo i semplici passaggi indicati di seguito:
- Carica i file PDF nel Cloud
- Firma documento PDF in Python
- Scarica il file risultante
Carica il documento
Prima di tutto, carica il documento PDF 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("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)
Di conseguenza, il file PDF caricato (sample.pdf) sarà disponibile nella sezione file della dashboard sul cloud.
Firma documenti PDF con codice QR utilizzando Python
Si prega di seguire i passaggi indicati di seguito per firmare il file PDF in modo programmatico.
- Crea un’istanza di SignApi
- Imposta il percorso del file PDF
- Definire SignQRCodeOptions
- Imposta il tipo di firma, il testo e il codice
- Imposta la posizione della firma
- Definisci impostazioni segno
- Assegna SignQRCodeOptions e SaveOptions a SignSettings
- Crea CreateSignaturesRequest
- Ottieni risultati chiamando il metodo SignApi.create\signatures().
Il seguente frammento di codice mostra come firmare un documento PDF utilizzando un’API REST.
# inizializzazione dell'API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "sample.pdf"
opts = groupdocs_signature_cloud.SignQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'
# impostare la posizione della firma su una pagina
opts.left = 450
opts.top = 0
opts.width = 90
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\\signedQRCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Firma documenti PDF con codice QR
Scarica il file firmato
L’esempio di codice precedente salverà il file PDF firmato sul cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:
# inizializzazione dell'API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("Output\\signedQRCode_sample.pdf", my_storage)
response = file_api.download_file(request)
# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")
Verifica le firme elettroniche utilizzando Python
Si prega di seguire i passaggi indicati di seguito per verificare le firme da un documento PDF firmato con codice QR a livello di programmazione.
- Crea un’istanza di SignApi
- Imposta il percorso del file PDF
- Definire VerifyQRCodeOptions
- Fornisci il tipo di firma, il testo e il codice
- Definisci impostazioni di verifica
- Assegna VerifyQRCodeOptions e FileInfo a VerifySettings
- Crea una richiesta di verifica della firma
- Ottieni risultati chiamando il metodo SignApi.verify\signatures().
Il seguente frammento di codice mostra come verificare le firme in un documento PDF utilizzando un’API REST.
# inizializzazione dell'API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "Output\\signedQRCode_sample.pdf"
opts = groupdocs_signature_cloud.VerifyQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'
opts.match_type = 'Contains'
opts.page = 1
settings = groupdocs_signature_cloud.VerifySettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.VerifySignaturesRequest(settings)
response = api.verify_signatures(request)
print('Signature Verified: ' + str(response.is_success))
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 firmare documenti PDF sul cloud con l’API REST della firma del documento utilizzando Python. Hai anche imparato come caricare in modo programmatico un file PDF sul 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 ambiguità, non esitate a contattarci sul forum.