# Podpis elektroniczny uruchamiany z Twojego systemu. > Publiczne API i biblioteki open source 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. Canonical page: https://autosignly.eu/pl/api Language: pl ## 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.** ### 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ść. ### 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. ### 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. ## 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 Java 17 lub nowsza. Jedyna zależność, którą dziedziczycie, to Jackson. ### Node.js Node 20 lub nowszy. Zero zależności - korzysta z tego, co Node ma w środku. ### Python Python 3.10 lub nowszy. Instalacja jedną komendą, jak każda inna paczka. 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. ## 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. ## 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ą. ## Frequently asked questions ### 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.