Klient Python

• PyPI: autosignly
• Kod i README: clients/python

pip install autosignly

Wersje: wspierana linia to 1.0.*. Najnowsze wydanie każdej paczki znajdziesz wśród tagów w repozytorium.

Python 3.10 lub nowszy. Oparty na httpx, z adnotacjami typów w całym kodzie.

Przykład

from autosignly import AutosignlyClient, Signer

with AutosignlyClient(api_key=..., api_secret=...) as client:
    document_id = client.upload_and_sign(
        pdf=open("doc.pdf", "rb").read(),
        document_name="Dokumnet współpracy",
        signers=[Signer(first_name="Anna", last_name="Nowak",
                        email="[email protected]", country="PL")],
    )

Co obejmuje

Wszystko, co wystawia API: dane klucza, listowanie i filtrowanie dokumentów (po statusie i po tagach), odczyt pojedynczego dokumentu, wgranie PDF-a z wysyłką lub bez, załączniki, wysyłkę do podpisu, pobranie pliku, tagi, kontrahentów — a do tego weryfikację podpisu webhooka i generator przechodzący duże listy strona po stronie.

Błędy przychodzą jako typowane wyjątki (NotFoundError, RateLimitError, ConnectionError, …), a odczyty są ponawiane z narastającym odstępem, więc czkawka sieci nie zamienia się w awarię Twojego kodu.

Jak jest testowany

Repozytorium niesie dwie suity, obie odpala uv run pytest:

• Testy jednostkowe przeciwko podstawionemu transportowi — nagłówki, budowa multiparta, ponowienia, mapowanie błędów
• Testy kontraktowe, które porównują każdą nazwę pola czytaną i wysyłaną przez klienta z opublikowaną specyfikacją OpenAPI — klient rozjechany z API wywala się sam

Osobno wewnętrzna suita e2e przechodzi całą ścieżkę na żywym środowisku: zakłada firmę, wgrywa PDF, dokłada załączniki, wysyła dokument do podpisu, podpisuje jako odbiorca i sprawdza zapieczętowany dokument, który wraca.