Upload document - Python

You can upload a document - Python by passing an array of files in the files parameter of the request and post to the /v1/files endpoint.

path = "/v1/files"
method = 'POST'
file = './classic-form-all-field-types.pdf'
files = {'file': (file, open(file, 'rb'), 'application/pdf')}
headers = generate_headers(method, path)
response = requests.request(method, url + path, headers=headers, timeout=30, files=files)

Code

main.py

import base64
import datetime
import hashlib
import hmac
import os
import requests
from dotenv import load_dotenv

load_dotenv() 

def get_error(response):
    """Extracts error message from a response object."""
    try:
        response_body = response.json()
    except ValueError:
        response_body = response.text.strip()

    if isinstance(response_body, dict) and 'errors' in response_body:
        errors = response_body['errors']
        if isinstance(errors, dict):
            return ','.join(str(v) for v in errors.values())
        return str(errors)

    return str(response_body) or response.reason

def generate_headers(method, path):
    """Generates authentication headers for the request."""
    private_key = os.environ.get('UNOPDF_PRIVATE_KEY')
    public_key = os.environ.get('UNOPDF_PUBLIC_KEY')
    timestamp = datetime.datetime.utcnow().strftime('%a, %d %b %Y %H:%M:%S GMT')
    payload = method.upper() +"\n" + timestamp + "\n" + path.lower()

    digest = hmac.new(private_key.encode('utf-8'), msg=payload.encode('utf-8'), digestmod=hashlib.sha256).digest()
    base64_encoded = base64.b64encode(digest)
    url_safe = base64_encoded.rstrip(b'=').replace(b'+', b'-').replace(b'/', b'_').decode('utf-8')
    auth_header = "SharedKey: " + public_key + ":" + url_safe

    return {'Authorization': auth_header, 'Timestamp': timestamp, 'Accept': 'application/json'}

def main():
    """Main function to execute the script."""
    url = os.environ.get('UNOPDF_API_URL')

#region upload_file
    path = "/v1/files"
    method = 'POST'
    file = './classic-form-all-field-types.pdf'
    files = {'file': (file, open(file, 'rb'), 'application/pdf')}
    headers = generate_headers(method, path)
    response = requests.request(method, url + path, headers=headers, timeout=30, files=files)
#endregion upload_file

    if response.status_code != 200:
        message = get_error(response)
        raise Exception("Error calling UnoPdf API: " + message)

    print(response.json())

if __name__ == "__main__":
    main()

requirements.txt

requests
python-dotenv