Klient Java

• Maven Central: eu.autosignly:autosignly-client
• Kod i README: clients/java

<dependency>
  <groupId>eu.autosignly</groupId>
  <artifactId>autosignly-client</artifactId>
  <version>1.0.0</version>
</dependency>

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

Java 17 lub nowsza. Jedyna zależność w runtime to Jackson; HTTP idzie przez klienta z JDK.

Przykład

var client = AutosignlyClient.of(System.getenv("AUTOSIGNLY_API_KEY"),
                                 System.getenv("AUTOSIGNLY_API_SECRET"));

String documentId = client.uploadAndSign(
        Files.readAllBytes(Path.of("doc.pdf")),
        "Dokumnet współpracy",
        "doc.pdf",
        SigningOptions.of(List.of(
                Signer.of("Anna", "Nowak", "[email protected]", "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 iterator przechodzący duże listy strona po stronie.

Błędy przychodzą jako typowane wyjątki (AutosignlyException.NotFound, .Connection, …), 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 mvn test:

• Testy jednostkowe przeciwko lokalnemu serwerowi HTTP — 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.