sign.yt

Podpis elektroniczny w systemach, których już używasz

Twój CRM, ERP albo portal klienta może tworzyć dokumenty, wysyłać je do podpisu i reagować w chwili podpisania, bez otwierania sign.yt.

Wersjonowane REST API

Wszystko jest dostępne pod api.sign.yt/v1 w formacie JSON: dokumenty, odbiorcy, pola, szablony i webhooki. Utworzenie dokumentu z szablonu, wysyłka i pobranie podpisanego PDF to kilka wywołań.

Każde zapytanie jest ograniczone do organizacji, do której należy klucz API, więc integracja nigdy nie zobaczy dokumentów innego klienta. Błędy wracają jako ustrukturyzowany JSON z czytelnymi kodami statusu, co upraszcza kod po Twojej stronie.

Klucze API z zakresem uprawnień

Każda organizacja tworzy własne klucze API i nadaje każdemu tylko potrzebne uprawnienia, odczyt lub zapis dla danego obszaru. Klucze przechowujemy jako skróty, po utworzeniu widać tylko prefiks, a każdy klucz ma limit 100 zapytań na sekundę.

Klucz możesz w każdej chwili unieważnić, a korzystające z niego integracje natychmiast przestają działać. Czas ostatniego użycia pomaga znaleźć klucze, których nikt już nie potrzebuje.

Webhooki, którym możesz ufać

Subskrybujesz zdarzenia takie jak document.sent, document.viewed, document.signed, document.completed, document.rejected, document.expired czy recipient.bounced. Każde wywołanie jest podpisane HMAC-SHA256 ze znacznikiem czasu i surową treścią, więc sprawdzisz, że pochodzi od sign.yt, i odrzucisz powtórzenia.

Adresy docelowe są sprawdzane przed każdą dostawą, co blokuje zapytania do adresów wewnętrznych. Każde wywołanie ma też w nagłówkach nazwę zdarzenia i identyfikator dostawy, co ułatwia kierowanie i deduplikację zdarzeń po Twojej stronie.

Ponowienia w standardzie

Gdy Twój serwer nie odpowiada, sign.yt ponawia próbę po 1 minucie, 5 minutach, 30 minutach, 2 godzinach i 12 godzinach. Każde wywołanie ma stały identyfikator do deduplikacji, a nieudane dostawy są zachowywane, więc nic nie ginie po cichu.

Każda próba jest podpisywana na nowo ze świeżym znacznikiem czasu, więc nawet ponowienie po kilku godzinach przejdzie po Twojej stronie kontrolę okna czasowego.

Zacznij integrację

Pełna dokumentacja API, pięciominutowy quickstart i oficjalne SDK dla Pythona i TypeScriptu.

pip install signyt
npm install @signyt/sdk

Najczęstsze pytania

Jak się uwierzytelnić?

Przekaż klucz API jako token Bearer w nagłówku Authorization.

Jak zweryfikować webhook?

Oblicz HMAC-SHA256 z nagłówka znacznika czasu, kropki i surowej treści, używając sekretu webhooka, i porównaj wynik z nagłówkiem X-Signyt-Signature.

Co się dzieje, gdy mój serwer nie odpowiada?

sign.yt ponawia próbę pięć razy w ciągu około 15 godzin, a potem oznacza dostawę jako nieudaną.

Które plany obejmują API?

Klucze API i webhooki są dostępne od planu Business wzwyż.

Inne funkcje

  • Dziennik audytu

    Każda czynność trafia do dziennika audytu, w którym wpisy są tylko dopisywane i powiązane łańcuchem skrótów. Do PDF dołączamy certyfikat ukończenia.

  • RODO

    Eksport i usuwanie danych na żądanie wbudowane w produkt, pliki PDF szyfrowane osobnym kluczem dla każdej organizacji i ścisła izolacja klientów.

  • Własne domeny

    Podpisy elektroniczne pod Twoją domeną, np. sign.twojafirma.pl. Dodajesz rekord CNAME, my weryfikujemy DNS i automatycznie wystawiamy certyfikat TLS.

Wszystkie funkcje