api

Publiczne API i biblioteki open source

Podpis elektroniczny uruchamiany z Twojego systemu.

Program, którego już używacie, może sam wysłać dokument do podpisu i sam odebrać gotowy plik – bez wchodzenia do naszej aplikacji i bez przeklejania dokumentów. Dostęp do API nie ma własnej opłaty, a do testów dostajecie darmowe sandbox’y oddzielone od produkcji.

Bez karty kredytowej · Bez abonamentu · Bez zobowiązań

Bez opłaty za dostęp

Nie ma planu API ani progu wejścia. Podpis kosztuje tyle samo, co klikany w panelu.

Gotowe biblioteki

Java, Node.js i Python. Kod publiczny na GitHubie, licencja Apache-2.0.

Darmowe sandbox’y

Do pięciu środowisk testowych obok produkcji. Wszystko w nich bezpłatne.

Jeden klucz różnicy

Ten sam adres i ten sam kod dla testów i produkcji. Przełączasz kluczem.

Co to znaczy w praktyce

Twój system wysyła dokument. Resztą zajmujemy się my.

Program, którego już używacie – CRM, system kadrowy, panel klienta, arkusz z makrem – może sam wysłać dokument do podpisu i sam odebrać gotowy plik. Nikt nie musi wchodzić do naszej aplikacji ani przeklejać plików.

1

System przekazuje dokument

Wasz program wysyła plik PDF i listę osób, które mają go podpisać – imię, nazwisko, e-mail, kraj. Jeśli podpisujących jest kilku, podajecie też kolejność.

2

Ludzie podpisują u siebie

Każda osoba dostaje mailem link i podpisuje na swoim telefonie albo komputerze. Kolejna dostaje swój link dopiero wtedy, gdy poprzednia skończy.

3

Wasz system wie od razu

Gdy dokument jest podpisany, wysyłamy powiadomienie do Waszego programu razem z gotowym plikiem. Nikt nie musi tego pilnować ręcznie ani sprawdzać skrzynki.

Open source

Gotowe biblioteki dla trzech najpopularniejszych języków.

Wasz programista nie zaczyna od zera i nie musi tłumaczyć naszej dokumentacji na kod. Dla Javy, Node.js i Pythona przygotowaliśmy gotowe biblioteki – dopisuje kilka linii i integracja działa. Wszystkie trzy powstają z jednej wspólnej specyfikacji, więc zachowują się identycznie i nie rozjeżdżają się między językami.

Kod jest publiczny na licencji Apache-2.0. Wasz zespół albo audytor może go przejrzeć przed wdrożeniem, a Wy nie jesteście w tym miejscu zależni wyłącznie od nas.

Java

Maven Central

Java 17 lub nowsza. Jedyna zależność, którą dziedziczycie, to Jackson.

eu.autosignly:autosignly-client

Node.js

npm

Node 20 lub nowszy. Zero zależności – korzysta z tego, co Node ma w środku.

npm install @16it/autosignly

Python

PyPI

Python 3.10 lub nowszy. Instalacja jedną komendą, jak każda inna paczka.

pip install autosignly

Nie podajemy tu numerów wersji, bo zmieniają się częściej niż ta strona – aktualną znajdziecie w repozytorium paczek swojego języka albo na GitHubie. Paczki są gotowe do pobrania publicznie, bez konta u nas; konto jest potrzebne dopiero po to, żeby wygenerować klucz dostępu.

Kod i przykłady na GitHubie

Integracja u siebie

Integrację można przetestować na własnym komputerze.

Żeby sprawdzić, czy powiadomienia z zewnętrznej usługi trafiają tam, gdzie mają, zwykle trzeba wystawić firmowy komputer do internetu. Dział IT nie lubi takich pytań, i słusznie.

Dlatego dajemy małe narzędzie, które przechwytuje ruch kierowany do Waszego systemu i przekierowuje go na komputer programisty. Nic nie musi być otwarte na świat, nie stawiacie żadnego tunelu ani reguły na firewallu.

Powiadomienia dochodzą w nieruszonej postaci, razem z podpisem, którym je zabezpieczamy. To, co zadziała na biurku programisty, zadziała tak samo na produkcji – nie ma tu żadnego trybu „tylko na testach”.

Przy logowaniu narzędzie wypisuje, do której firmy i którego środowiska prowadzi klucz, i wyraźnie ostrzega, gdy trafiliście na produkcję. Dane produkcyjne i testowe mogą leżeć obok siebie, bez ryzyka pomyłki.

$ npm install -g autosignly $ autosignly login Klucz i sekret utworzone w aplikacji. Sekret wpisujesz bez wyświetlania na ekranie. $ autosignly listen –forward-to http://localhost:8000/webhooks ok DOCUMENT_SIGNED -> 200 (48 ms) ok DOCUMENT_SIGNED -> 200 (51 ms)

Środowiska testowe

Pięć darmowych sandbox’ów obok produkcji.

Sandbox to osobne, pełne środowisko do testów – z własnymi danymi i własnym kluczem dostępu. Dzięki temu nikt, ucząc się integracji, nie wyśle przez pomyłkę prawdziwego dokumentu do prawdziwego klienta. Możecie mieć do pięciu sandbox’ów, na przykład po jednym na zespół albo na kolejne podejście do wdrożenia.

Adres jest ten sam dla testów i produkcji – o tym, w którym środowisku pracujecie, decyduje wyłącznie użyty klucz. Przejście z testów na produkcję nie wymaga więc przepisywania integracji.

Wszystko w sandboxie jest bezpłatne

Podpisy składane w sandboxie nie zawierają kryptografii – nie kupujemy do nich kwalifikowanego znacznika czasu ani pieczęci, więc nie ma za co pobierać opłaty. Testujecie tyle, ile potrzebujecie, a płacicie dopiero za dokumenty podpisane na produkcji.

Czym sandbox różni się od produkcji

Podpis bez wartości prawnej

Dokument z sandboxa dostaje pieczęć wyłącznie wizualną, bez kryptografii. Służy do sprawdzenia przebiegu, nie do podpisania czegokolwiek realnego.

Znak wodny na dokumentach

Dokumenty generowane z szablonów w sandboxie mają znak wodny, żeby nikt nie wziął testowego egzemplarza za obowiązujący.

Bez maili do podpisujących

W sandboxie nie wysyłamy zaproszeń mailem – link do podpisu odbiera Wasz system. Testy nie trafią do skrzynki prawdziwego kontrahenta.

Dane całkowicie oddzielone

Klucz sandboxowy nie widzi produkcyjnych dokumentów, kontrahentów ani tagów. Sandbox można też skasować razem z całą zawartością.

FAQ

Pytania, które zada Wasz dział IT i osoba płacąca faktury.

Najczęstsze wątpliwości przy wdrożeniu integracji – koszty, środowiska testowe i to, czym sandbox różni się od produkcji.

Sowa AutoSignly

Pełna dokumentacja techniczna i przykłady są publiczne – nie musicie zakładać konta, żeby je przejrzeć.

Masz pytanie spoza listy? Napisz do nas – odpowiadamy tego samego dnia roboczego.

Napisz do nas →
Czy za dostęp do API trzeba płacić dodatkowo?+

Nie. Dostęp do API, klucze, powiadomienia i biblioteki klienckie nie mają własnej opłaty – płacisz dokładnie tyle, ile podpisując w aplikacji: od 0,25 AC za podpis prosty i 0,88 AC za podpis z weryfikacją SMS dla Polski. Nie ma planu API, progu wejścia ani pakietu wywołań do wykupienia osobno.

Ile mogę mieć sandbox’ów?+

Do pięciu obok produkcji, czyli sześć środowisk razem. Każdy zakładasz pod własną nazwą i dostajesz do niego osobny klucz dostępu. W praktyce wystarcza to na podział po jednym na zespół albo na osobne środowisko dla testów automatycznych.

Czy sandbox’y są darmowe?+

Tak – wszystkie operacje w sandboxie są bezpłatne. Podpisy składane w sandboxie nie zawierają kryptografii, więc nie kupujemy do nich kwalifikowanego znacznika czasu ani pieczęci i nie ma za co pobierać opłaty. Testujesz tyle, ile potrzebujesz, a płacisz dopiero za dokumenty podpisane na produkcji.

Czym różni się sandbox od środowiska produkcyjnego?+

Adres jest ten sam – o środowisku decyduje użyty klucz, więc integracji nie trzeba przepisywać przy przejściu na produkcję. Różnice są cztery: podpis z sandboxa nie ma wartości prawnej (pieczęć jest wyłącznie wizualna, bez kryptografii), dokumenty generowane z szablonów mają znak wodny, zaproszenia do podpisu nie są wysyłane mailem (link odbiera Twój system, więc testy nie trafią do prawdziwego kontrahenta), a dane są całkowicie oddzielone od produkcyjnych. Przebieg, statusy i powiadomienia są identyczne.

Czy płacę za użytkowników?+

Pierwszy użytkownik konta jest gratis, każdy następny kosztuje 5 AC miesięcznie. Użytkownik to osoba w Twojej firmie, która wysyła dokumenty i zarządza obiegiem. Podpisujący nie potrzebują konta – płacisz za ich podpis, a nie za konto.

Czym są kredyty AC?+

AC to AutoCoin – wewnętrzna waluta AutoSignly, w której rozliczasz podpisy i weryfikacje. Przelicznik jest prosty: 1 AC = 1 zł netto. Doładowujesz konto kwotą, jaką chcesz – np. za doładowanie 100 AC dostajesz 100 kredytów do wykorzystania w systemie, a fakturę na 123 zł (100 zł netto + 23% VAT). Kredytami płacisz za podpisy, weryfikacje i usługi dodatkowe – bez abonamentu i bez pakietów, które przepadają na koniec miesiąca.

Bezpłatna konsultacja

Pokażemy AutoSignly na Twoich dokumentach – w 15 minut.

Zostaw kontakt i powiedz, jakie dokumenty podpisujesz. Oddzwonimy, pokażemy proces na żywo i policzymy, ile zaoszczędzisz na obiegu papieru i abonamencie.

  • Konkrety na Twoich dokumentach, nie handlowa prezentacja
  • Wyliczymy Twój realny koszt – bez abonamentu i ukrytych dopłat
  • Bezpłatnie pomożemy przenieść szablony z dotychczasowej platformy

Bez zobowiązań i bez nacisku. Jeśli po rozmowie uznasz, że to nie dla Twojej firmy – po prostu daj znać, i tyle.

Oddzwaniamy w godzinach pracy, zwykle tego samego dnia. Twoje dane wykorzystamy wyłącznie do kontaktu w tej sprawie – zgodnie z polityką prywatności.