znak odporny (wersja zapoznawcza)
Użyj znaku odpornego na uszkodzenia, aby zautomatyzować bezpieczne przepływy pracy podpisu elektronicznego dla dokumentów PDF i DOCX. Organizacje mogą tworzyć lub przygotowywać żądania podpisu pojedynczego lub wielodysekrotnego, przypisywać adresatów i role podpisywania, wyświetlać listy i śledzić dokumenty, pobierać ukończone pliki PDF i usuwać dokumenty. Wymagane jest niezawodne konto podpisywania, plan obsługujący wybrane akcje i typy podpisów oraz prawidłowy token interfejsu API.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Name | Obsługa interfejsu API |
| adres URL | https://sproof.com |
| support@sproof.com |
| Metadane łącznika | |
|---|---|
| Publisher | sproof GmbH |
| Witryna internetowa | https://www.sproof.com/en/sign/ |
| Zasady ochrony prywatności | https://www.sproof.com/en/privacy-policy-app/ |
| Kategorie | Produktywność; Zawartość i pliki |
znak odporny
Przegląd
Znak odporny umożliwia organizacjom automatyzowanie przepływów pracy podpisów elektronicznych dla dokumentów PDF i DOCX. Łącznik może tworzyć lub przygotowywać żądania podpisu pojedynczego dokumentu lub koperty z wieloma dokumentami, przypisywać adresatów i role podpisywania, wyświetlać dokumenty, pobierać stan żądania, pobierać ukończone dokumenty i usuwać dokumenty.
Aktualizacje w tej wersji
- Dodano pozycję Przygotuj żądanie podpisu , aby utworzyć wersję roboczą bez zapraszania adresatów.
- Dodano pozycję Pobierz dokumenty do listy, filtrowania, sortowania i wyszukiwania dokumentów.
- Brak zmian powodujących niezgodność w istniejących akcjach łącznika.
Wymagania wstępne
Do korzystania z łącznika potrzebne są następujące elementy:
- Niezawodne konto podpisywania.
- Niezawodny plan podpisywania z dostępem do interfejsu API i obsługą wymaganych akcji i typów podpisów.
- Prawidłowy token interfejsu API podpisywania niezawodnego.
Authentication
Łącznik używa uwierzytelniania tokenu interfejsu API. Utwórz połączenie, wprowadzając prawidłowy token interfejsu API podpisywania niezawodnego skojarzony z kontem. Zachowaj bezpieczeństwo tokenu i zastąp go, jeśli zostanie odwołany lub ponownie wygenerowany.
Obsługiwane akcje
- Tworzenie żądania podpisu — tworzy żądanie dla jednego dokumentu lub koperty zawierającej wiele dokumentów. Adresaci, role podpisywania, kolejność podpisywania, pozycje podpisu i inne ustawienia zaproszeń można skonfigurować.
- Tworzenie żądania podpisu przy użyciu symboli zastępczych — tworzy żądanie przy użyciu symboli zastępczych przechowywanych w przekazanym dokumencie. Informacje o adresatach i pozycje podpisu są wyodrębniane z tych symboli zastępczych.
- Przygotowywanie żądania podpisu — tworzy żądanie podpisu wersji roboczej bez zapraszania adresatów. Zwrócony identyfikator elementu członkowskiego może służyć do otwierania i przygotowywania dokumentu w edytorze znaków odpornych.
- Pobieranie dokumentów — wyświetla dokumenty dostępne dla połączonego konta sign. Opcje stronicowania, filtrowania, sortowania i wyszukiwania mogą służyć do zawężenia wyniku.
- Uzyskiwanie stanu żądania — pobiera bieżący stan i stan podpisywania żądania podpisu przy użyciu jego identyfikatora elementu członkowskiego.
- Pobieranie dokumentu — pobiera dokument jako binarny plik PDF lub plik PDF zakodowany w formacie Base64.
- Usuwanie dokumentu — usuwa dokument lub usuwa dostęp członka w zależności od podanego identyfikatora członka, roli członka i tego, czy dokument należy do koperty.
Znane ograniczenia i wymagania
- Dokumenty wejściowe muszą być dostarczane jako zawartość PDF lub DOCX zakodowana w formacie Base64.
- Koperta może zawierać maksymalnie 25 dokumentów.
- Nazwa koperty jest wymagana w przypadku przesłania więcej niż jednego dokumentu.
- Żądania oparte na symbolach zastępczych wymagają poprawnie sformatowanych symboli zastępczych w przekazanym dokumencie.
- W przypadku żądań opartych na symbolach zastępczych adresaci i pozycje podpisów są uzyskiwane z dokumentu, a nie wprowadzane ręcznie.
- Dostępne akcje, typy podpisów i dostawcy zależą od połączonego konta i planu podpisywania.
- Zachowanie usuwania dokumentu zależy od tego, czy podany identyfikator elementu członkowskiego należy do nadawcy, czy adresata i czy dokument jest częścią koperty.
Support
Aby uzyskać pomoc techniczną dotyczącą łącznika lub interfejsu API, skontaktuj się z .support@sproof.com
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| kod przedpłaty | securestring | "token" für diese API | True |
Akcje
| Pobieranie dokumentu |
Pobierz podpisany dokument jako ciąg binarny lub zakodowany w formacie Base64. |
| Pobieranie dokumentów |
Zwraca dokumenty utworzone przez właściciela tokenu interfejsu API (uwierzytelnionego użytkownika), niezależnie od tego, czy te dokumenty zostały utworzone za pośrednictwem interfejsu użytkownika, czy za pośrednictwem interfejsu API. Dokumenty utworzone przez innych członków tego samego planu nie są uwzględniane. Po włączeniu zarządzania rolami dla planu każdy użytkownik może mieć własny token interfejsu API. |
| Przygotowywanie żądania podpisu |
Tworzy żądanie podpisu wersji roboczej bez zapraszania adresatów. Użyj zwróconego identyfikatora elementu członkowskiego, aby otworzyć dokument w edytorze odpornych podpisów. |
| Tworzenie żądania podpisu |
Jest to nowe żądanie utworzenia podpisu. Oprócz tworzenia pojedynczego zaproszenia do dokumentu obsługuje teraz tworzenie kopert i przekazywanie wielu dokumentów jednocześnie podczas wysyłania zaproszeń. |
| Tworzenie żądania podpisu przy użyciu symboli zastępczych |
Tworzy żądanie podpisu przy użyciu symboli zastępczych przechowywanych w przekazanym dokumencie. Adresaci i pozycje podpisów są wyodrębniane z dokumentu. |
| Usuwanie dokumentu |
Usuwa dokument lub usuwa do niego dostęp członka, w zależności od tego, czy podany Dokumenty w kopercie Parametr Za pomocą nadawcy
Za pomocą adresata
Pojedyncze dokumenty Za pomocą nadawcy
Za pomocą nadawcy
Za pomocą adresata
|
| Uzyskiwanie stanu żądania |
Uzyskaj stan żądania podpisu. Zwraca obiekt JSON dokumentu lub błąd. Parametr jest zwracany przez żądanie pocztowe w dokumencie i jest skojarzony z wiadomością e-mail nadawców. |
Pobieranie dokumentu
Pobierz podpisany dokument jako ciąg binarny lub zakodowany w formacie Base64.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator elementu członkowskiego
|
memberId | True | string |
Identyfikator elementu członkowskiego |
|
Format pobierania
|
format | string |
Określa format odpowiedzi. Służy |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
base64
|
base64 | string |
Zawartość PDF zakodowana w formacie Base64 |
Pobieranie dokumentów
Zwraca dokumenty utworzone przez właściciela tokenu interfejsu API (uwierzytelnionego użytkownika), niezależnie od tego, czy te dokumenty zostały utworzone za pośrednictwem interfejsu użytkownika, czy za pośrednictwem interfejsu API.
Dokumenty utworzone przez innych członków tego samego planu nie są uwzględniane. Po włączeniu zarządzania rolami dla planu każdy użytkownik może mieć własny token interfejsu API.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wpisy na stronę
|
perPage | integer |
Określ liczbę wpisów na stronę. |
|
|
Numer strony
|
page | integer |
Określ numer strony. |
|
|
Filtr dokumentu
|
view | string |
Określ filtr dokumentu. |
|
|
Sortowanie dokumentów
|
sort | string |
Sortowanie dokumentów. Dołącz ciąg ":true" do sortowania malejącego. |
|
|
Kwerenda wyszukiwania
|
query | string |
Wyszukaj zapytanie o różne informacje. Zachowanie:
|
|
|
Filtr etykiet
|
labels | string |
Filtruj dokumenty według nazwy etykiety. |
|
|
Utworzone na podstawie
|
startDate | date-time |
Filtruje wyniki rozpoczynające się od określonej wartości utworzonej Data i godzina w formacie UTC ( nie filtruje według wartości updatedAt). Użyj tego parametru w połączeniu z parametrem "endDate", aby zdefiniować zakres czasu. |
|
|
Utworzono do
|
endDate | date-time |
Filtruje wyniki kończące się na określonej wartości createdAt daty i godziny w formacie UTC ( nie filtruje według wartości updatedAt). Użyj tego parametru w połączeniu z parametrem "startDate", aby zdefiniować zakres czasu. |
Zwraca
Obiekt odpowiedzi dla operacji listy dokumentów
- Odpowiedź na listę dokumentów
- _DocumentListResponse
Przygotowywanie żądania podpisu
Tworzy żądanie podpisu wersji roboczej bez zapraszania adresatów. Użyj zwróconego identyfikatora elementu członkowskiego, aby otworzyć dokument w edytorze odpornych podpisów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
e-mail
|
True | string |
Adres e-mail nadawcy. Musi należeć do członka planu. |
|
|
firstName
|
firstName | True | string |
Imię nadawcy. |
|
lastName
|
lastName | string |
Nazwisko nadawcy. |
|
|
rola
|
role | string |
Rola nadawcy we wszystkich dokumentach. |
|
|
e-mail
|
string |
Adres e-mail odbiorcy. |
||
|
firstName
|
firstName | string |
Imię odbiorcy. |
|
|
lastName
|
lastName | string |
Nazwisko odbiorcy. |
|
|
doNotSendEmails
|
doNotSendEmails | boolean |
Jeśli ustawiono |
|
|
customId
|
customId | string |
Do użycia tylko wtedy, gdy adres e-mail adresata jest nieznany w momencie zapraszania. Działa to tylko wtedy, gdy zapraszasz adresatów (nie do przygotowywania tras) i chcesz użyć funkcji fastlane. Element Uwaga: identyfikator customId może służyć tylko do kompilowania linku odbiorcy do dokumentu. Nie można go używać dla innych żądań zamiast identyfikatora memberId. Aby uzyskać szczegółowe informacje na temat budowy adresu URL, zobacz Otwieranie dokumentu przy użyciu identyfikatora niestandardowego |
|
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
phoneNumber
|
phoneNumber | string |
Numer telefonu tego adresata. Jest to używane do weryfikacji wiadomości SMS. (np. +43 699 1234 1234). |
|
|
privateMessage
|
privateMessage | string |
Prywatna wiadomość dla tego konkretnego adresata. |
|
|
inPersonMode
|
inPersonMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie musiał podpisać dokument osobiście i nie zostanie wysłana żadna wiadomość e-mail. Ten tryb jest dostępny tylko przy użyciu typu podpisu SES |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "qualifiedPlusIdent", "simple" |
|
|
oznaczyć
|
tag | string |
Ten tag określa dostawcę tożsamości, który będzie używany do procesu podpisywania. Wybierz spośród wstępnie zdefiniowanego zestawu obsługiwanych dostawców.
Uwaga2: W przypadku używania |
|
|
canChange
|
canChange | boolean |
Wartość logiczna określająca, czy zaproszony odbiorca powinien mieć możliwość zmiany dostawcy podpisu |
|
|
country
|
country | string |
Domyślny kraj, jeśli jest pusty dla wszystkich, zostanie zwrócony błąd z wybranym tagiem dostawcy |
|
|
data ukończenia
|
dueDate | YYYY-MM-DD |
Data podpisania dokumentu. Ta data ukończenia jest wyświetlana adresatowi w wiadomości e-mail z zaproszeniem i jest również widoczna w sekcji szczegółów dokumentu pulpitu nawigacyjnego. Służy jako termin ukończenia procesu podpisywania. |
|
|
reminderInterval
|
reminderInterval | number |
Określa liczbę dni między wiadomościami e-mail z przypomnieniami. |
|
|
startSendingReminders
|
startSendingReminders | YYYY-MM-DD HH:MM |
Data wysłania przypomnień |
|
|
inviteLanguage
|
inviteLanguage | string |
Określa język wiadomości e-mail wysyłanych do anonimowych użytkowników, którzy nie mają konta. W przypadku użytkowników z kontem zostanie użyty język wybrany w swoim profilu. |
|
|
komunikat
|
message | string |
Wiadomość niestandardowa wysłana do adresatów w wiadomości e-mail. |
|
|
subject
|
subject | string |
Wiersz tematu wiadomości e-mail wysłanej do adresatów. |
|
|
sendOutFinishedPdf
|
sendOutFinishedPdf | boolean |
Jeśli ustawiono wartość true, plik PDF zostanie wysłany jako załącznik do wszystkich adresatów dokumentu (jeśli jest mniejszy niż 5 MB). |
|
|
focusedSigningMode
|
focusedSigningMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie ograniczony do podpisywania lub odrzucania dokumentu i nie będzie mógł przejść z dala od strony. |
|
|
allowForwarding
|
allowForwarding | boolean |
Zezwalaj na przekazywanie zaproszenia. |
|
|
collabSigningMode
|
collabSigningMode | object |
Obiekt, w którym każdy klucz reprezentuje rundę podpisywania, a jego odpowiadająca wartość wskazuje, czy podpisywanie współpracy jest włączone dla tej rundy. Jeśli wartość ma wartość true, wymagany jest tylko jeden podpis, aby ukończyć określoną rundę podpisywania i przejść do następnej rundy. Na przykład { "1": true } oznacza, że w rundzie podpisywania "1" wymagany jest tylko jeden podpis. |
|
|
usePlaceholders
|
usePlaceholders | boolean |
Jeśli wartość true, symbole zastępcze/pola tekstowe przechowywane w dokumencie będą używane do zapraszania adresatów. |
|
|
inPersonSigning
|
inPersonSigning | boolean |
Jeśli to prawda, odbiorca otrzymuje wyskakujące okienko, w którym musi ręcznie narysować podpis |
|
|
folderName
|
folderName | string |
Jeśli zostanie podana, zostanie utworzona koperta zawierająca wszystkie dokumenty w dokumencieDataArray. (Wymagane w przypadku wysłania więcej niż jednego dokumentu) |
|
|
callbackUrl (adres URL wywołania zwrotnego)
|
callbackUrl | string |
Żądanie POST, w tym dokument, zostanie wysłane do tego adresu URL po utworzeniu nowego podpisu lub odrzuceniu dokumentu przez adresata. W przypadku awarii istnieje mechanizm ponawiania prób, aby upewnić się, że żądanie zostanie ponowione. |
|
|
Returnurl
|
returnUrl | string |
Link przycisku powrotu po podpisaniu dokumentu |
|
|
returnBtnText
|
returnBtnText | string |
Tekst przycisku powrotu po podpisaniu dokumentu |
|
|
dane
|
data | True | string |
Dane dokumentu (PDF lub DOCX) w formacie base64. |
|
mimetype
|
mimetype | string |
Typ MIME zakodowanych danych base64 PDF lub DOCX, wymagany, jeśli dokument nie jest plikiem PDF |
|
|
fileName
|
fileName | True | string |
Nazwa pliku |
|
etykieta
|
label | string |
Etykieta niestandardowa, którą można wysłać w celu organizowania dokumentów. |
|
|
page
|
page | True | integer |
Liczba stron, na których znajduje się pole, a pierwsza strona wynosi 0. |
|
Pagewidth
|
pageWidth | number |
Dowolna wartość całkowita opisująca szerokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 478 jako wartość domyślną. |
|
|
Pageheight
|
pageHeight | number |
Dowolna wartość całkowita opisująca wysokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 676 jako wartość domyślną. |
|
|
x
|
x | True | float |
Reprezentuje położenie poziome pola jako procent szerokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest ustawione na 10% szerokości strony po lewej stronie. |
|
y
|
y | True | float |
Przedstawia położenie pola w pionie jako procent wysokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest umieszczone na 10% wysokości strony od góry. |
|
width
|
width | True | float |
Szerokość pola na podstawie wymiarów strony, podobnie jak współrzędne x i y. Jest to zmiennoprzecinkowa reprezentująca procent stronyWidth. |
|
height
|
height | True | float |
Wysokość pola na podstawie wymiarów strony, podobnie jak współrzędnych x i y. Jest to zmiennoprzecinkowy reprezentujący procent stronyHeight. |
|
id
|
id | True | string |
Unikatowy identyfikator tego pola wygenerowany w dowolny sposób. |
|
etykieta
|
label | string |
Tekst zastępczy, taki jak nazwa pola, np. "Data urodzenia". |
|
|
value
|
value | string |
Wartość domyślna pola. Może mieć wartość null. Jeśli pole ma typ "chooseBox", wartość może mieć wartość null lub jeden z ciągów zdefiniowanych w opcjach. |
|
|
identyfikator pola
|
fieldId | string |
Stabilny identyfikator pola skonfigurowany w interfejsie użytkownika. Służy do wstępnego wypełniania pól formularza przepływu pracy za pośrednictwem żądań interfejsu API. |
|
|
tylko do odczytu
|
readonly | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może zmodyfikować wartości tego pola. |
|
|
required
|
required | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może podpisać dokumentu bez wypełniania tego pola. |
|
|
typ
|
type | True | string | |
|
wielowierszowy
|
multiline | boolean |
Określa, czy wiele wierszy jest dozwolonych. |
|
|
displayValue
|
displayValue | True | string | |
|
exportValue
|
exportValue | True | string | |
|
grupa
|
group | number |
Każde pole radiowe można przypisać do grupy. |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego dokumentu może zostać zastąpiony przez typ podpisu adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "simple", "qualifiedPlusIdent" |
|
|
identyfikator refId
|
refId | string |
Identyfikator refId jest opcjonalnym polem używanym do krzyżowego odwoływanie się do przekazanego dokumentu. Jeśli zostanie podana, umożliwia przypisanie niestandardowego identyfikatora odwołania do dokumentu, który zostanie zwrócony jako część obiektu dokumentu w przyszłych odpowiedziach interfejsu API. Może to być przydatne do śledzenia lub organizowania dokumentów przez system zewnętrzny lub przepływ pracy. |
|
|
język
|
language | string |
Język dokumentów. |
|
|
folderId
|
folderId | string |
Identyfikator folderu, do którego należy wstawić dokumenty. Jest to możliwe tylko wtedy, gdy zarówno inviteData, jak i folderName są niezdefiniowane. |
|
|
isAttachment
|
isAttachment | boolean |
Usługa isAttachment nie jest wymagana w tym przypadku. |
|
|
Szczegóły adresata
|
recipientDetails | True | object |
Szczegóły adresata są kluczem wiadomości e-mail adresata. Przykład: {""mail@test.com:{"role":"signer","signaturePositions":[{"page":0,"x":0.55,"y":0.80,"width":0.25,"height":0.0.08}]}}. |
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
fastlaneProfileId
|
fastlaneProfileId | uuid |
Określ profil rozwiązania Fastlane, który ma być używany z tym dokumentem. (parametr useFastlane musi być ustawiony na wartość true). |
Zwraca
Tworzenie żądania podpisu
Jest to nowe żądanie utworzenia podpisu. Oprócz tworzenia pojedynczego zaproszenia do dokumentu obsługuje teraz tworzenie kopert i przekazywanie wielu dokumentów jednocześnie podczas wysyłania zaproszeń.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
e-mail
|
True | string |
Adres e-mail nadawcy. Musi należeć do członka planu. |
|
|
firstName
|
firstName | True | string |
Imię nadawcy. |
|
lastName
|
lastName | string |
Nazwisko nadawcy. |
|
|
rola
|
role | string |
Rola nadawcy we wszystkich dokumentach. |
|
|
e-mail
|
string |
Adres e-mail odbiorcy. |
||
|
firstName
|
firstName | string |
Imię odbiorcy. |
|
|
lastName
|
lastName | string |
Nazwisko odbiorcy. |
|
|
doNotSendEmails
|
doNotSendEmails | boolean |
Jeśli ustawiono |
|
|
customId
|
customId | string |
Do użycia tylko wtedy, gdy adres e-mail adresata jest nieznany w momencie zapraszania. Działa to tylko wtedy, gdy zapraszasz adresatów (nie do przygotowywania tras) i chcesz użyć funkcji fastlane. Element Uwaga: identyfikator customId może służyć tylko do kompilowania linku odbiorcy do dokumentu. Nie można go używać dla innych żądań zamiast identyfikatora memberId. Aby uzyskać szczegółowe informacje na temat budowy adresu URL, zobacz Otwieranie dokumentu przy użyciu identyfikatora niestandardowego |
|
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
phoneNumber
|
phoneNumber | string |
Numer telefonu tego adresata. Jest to używane do weryfikacji wiadomości SMS. (np. +43 699 1234 1234). |
|
|
privateMessage
|
privateMessage | string |
Prywatna wiadomość dla tego konkretnego adresata. |
|
|
inPersonMode
|
inPersonMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie musiał podpisać dokument osobiście i nie zostanie wysłana żadna wiadomość e-mail. Ten tryb jest dostępny tylko przy użyciu typu podpisu SES |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "qualifiedPlusIdent", "simple" |
|
|
oznaczyć
|
tag | string |
Ten tag określa dostawcę tożsamości, który będzie używany do procesu podpisywania. Wybierz spośród wstępnie zdefiniowanego zestawu obsługiwanych dostawców.
Uwaga2: W przypadku używania |
|
|
canChange
|
canChange | boolean |
Wartość logiczna określająca, czy zaproszony odbiorca powinien mieć możliwość zmiany dostawcy podpisu |
|
|
country
|
country | string |
Domyślny kraj, jeśli jest pusty dla wszystkich, zostanie zwrócony błąd z wybranym tagiem dostawcy |
|
|
data ukończenia
|
dueDate | YYYY-MM-DD |
Data podpisania dokumentu. Ta data ukończenia jest wyświetlana adresatowi w wiadomości e-mail z zaproszeniem i jest również widoczna w sekcji szczegółów dokumentu pulpitu nawigacyjnego. Służy jako termin ukończenia procesu podpisywania. |
|
|
reminderInterval
|
reminderInterval | number |
Określa liczbę dni między wiadomościami e-mail z przypomnieniami. |
|
|
startSendingReminders
|
startSendingReminders | YYYY-MM-DD HH:MM |
Data wysłania przypomnień |
|
|
inviteLanguage
|
inviteLanguage | string |
Określa język wiadomości e-mail wysyłanych do anonimowych użytkowników, którzy nie mają konta. W przypadku użytkowników z kontem zostanie użyty język wybrany w swoim profilu. |
|
|
komunikat
|
message | string |
Wiadomość niestandardowa wysłana do adresatów w wiadomości e-mail. |
|
|
subject
|
subject | string |
Wiersz tematu wiadomości e-mail wysłanej do adresatów. |
|
|
sendOutFinishedPdf
|
sendOutFinishedPdf | boolean |
Jeśli ustawiono wartość true, plik PDF zostanie wysłany jako załącznik do wszystkich adresatów dokumentu (jeśli jest mniejszy niż 5 MB). |
|
|
focusedSigningMode
|
focusedSigningMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie ograniczony do podpisywania lub odrzucania dokumentu i nie będzie mógł przejść z dala od strony. |
|
|
allowForwarding
|
allowForwarding | boolean |
Zezwalaj na przekazywanie zaproszenia. |
|
|
collabSigningMode
|
collabSigningMode | object |
Obiekt, w którym każdy klucz reprezentuje rundę podpisywania, a jego odpowiadająca wartość wskazuje, czy podpisywanie współpracy jest włączone dla tej rundy. Jeśli wartość ma wartość true, wymagany jest tylko jeden podpis, aby ukończyć określoną rundę podpisywania i przejść do następnej rundy. Na przykład { "1": true } oznacza, że w rundzie podpisywania "1" wymagany jest tylko jeden podpis. |
|
|
usePlaceholders
|
usePlaceholders | boolean |
Jeśli wartość true, symbole zastępcze/pola tekstowe przechowywane w dokumencie będą używane do zapraszania adresatów. |
|
|
inPersonSigning
|
inPersonSigning | boolean |
Jeśli to prawda, odbiorca otrzymuje wyskakujące okienko, w którym musi ręcznie narysować podpis |
|
|
folderName
|
folderName | string |
Jeśli zostanie podana, zostanie utworzona koperta zawierająca wszystkie dokumenty w dokumencieDataArray. (Wymagane w przypadku wysłania więcej niż jednego dokumentu) |
|
|
callbackUrl (adres URL wywołania zwrotnego)
|
callbackUrl | string |
Żądanie POST, w tym dokument, zostanie wysłane do tego adresu URL po utworzeniu nowego podpisu lub odrzuceniu dokumentu przez adresata. W przypadku awarii istnieje mechanizm ponawiania prób, aby upewnić się, że żądanie zostanie ponowione. |
|
|
Returnurl
|
returnUrl | string |
Link przycisku powrotu po podpisaniu dokumentu |
|
|
returnBtnText
|
returnBtnText | string |
Tekst przycisku powrotu po podpisaniu dokumentu |
|
|
dane
|
data | True | string |
Dane dokumentu (PDF lub DOCX) w formacie base64. |
|
mimetype
|
mimetype | string |
Typ MIME zakodowanych danych base64 PDF lub DOCX, wymagany, jeśli dokument nie jest plikiem PDF |
|
|
fileName
|
fileName | True | string |
Nazwa pliku |
|
etykieta
|
label | string |
Etykieta niestandardowa, którą można wysłać w celu organizowania dokumentów. |
|
|
page
|
page | True | integer |
Liczba stron, na których znajduje się pole, a pierwsza strona wynosi 0. |
|
Pagewidth
|
pageWidth | number |
Dowolna wartość całkowita opisująca szerokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 478 jako wartość domyślną. |
|
|
Pageheight
|
pageHeight | number |
Dowolna wartość całkowita opisująca wysokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 676 jako wartość domyślną. |
|
|
x
|
x | True | float |
Reprezentuje położenie poziome pola jako procent szerokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest ustawione na 10% szerokości strony po lewej stronie. |
|
y
|
y | True | float |
Przedstawia położenie pola w pionie jako procent wysokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest umieszczone na 10% wysokości strony od góry. |
|
width
|
width | True | float |
Szerokość pola na podstawie wymiarów strony, podobnie jak współrzędne x i y. Jest to zmiennoprzecinkowa reprezentująca procent stronyWidth. |
|
height
|
height | True | float |
Wysokość pola na podstawie wymiarów strony, podobnie jak współrzędnych x i y. Jest to zmiennoprzecinkowy reprezentujący procent stronyHeight. |
|
id
|
id | True | string |
Unikatowy identyfikator tego pola wygenerowany w dowolny sposób. |
|
etykieta
|
label | string |
Tekst zastępczy, taki jak nazwa pola, np. "Data urodzenia". |
|
|
value
|
value | string |
Wartość domyślna pola. Może mieć wartość null. Jeśli pole ma typ "chooseBox", wartość może mieć wartość null lub jeden z ciągów zdefiniowanych w opcjach. |
|
|
identyfikator pola
|
fieldId | string |
Stabilny identyfikator pola skonfigurowany w interfejsie użytkownika. Służy do wstępnego wypełniania pól formularza przepływu pracy za pośrednictwem żądań interfejsu API. |
|
|
tylko do odczytu
|
readonly | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może zmodyfikować wartości tego pola. |
|
|
required
|
required | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może podpisać dokumentu bez wypełniania tego pola. |
|
|
typ
|
type | True | string | |
|
wielowierszowy
|
multiline | boolean |
Określa, czy wiele wierszy jest dozwolonych. |
|
|
displayValue
|
displayValue | True | string | |
|
exportValue
|
exportValue | True | string | |
|
grupa
|
group | number |
Każde pole radiowe można przypisać do grupy. |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego dokumentu może zostać zastąpiony przez typ podpisu adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "simple", "qualifiedPlusIdent" |
|
|
identyfikator refId
|
refId | string |
Identyfikator refId jest opcjonalnym polem używanym do krzyżowego odwoływanie się do przekazanego dokumentu. Jeśli zostanie podana, umożliwia przypisanie niestandardowego identyfikatora odwołania do dokumentu, który zostanie zwrócony jako część obiektu dokumentu w przyszłych odpowiedziach interfejsu API. Może to być przydatne do śledzenia lub organizowania dokumentów przez system zewnętrzny lub przepływ pracy. |
|
|
język
|
language | string |
Język dokumentów. |
|
|
folderId
|
folderId | string |
Identyfikator folderu, do którego należy wstawić dokumenty. Jest to możliwe tylko wtedy, gdy zarówno inviteData, jak i folderName są niezdefiniowane. |
|
|
isAttachment
|
isAttachment | boolean |
Usługa isAttachment nie jest wymagana w tym przypadku. |
|
|
Szczegóły adresata
|
recipientDetails | True | object |
Szczegóły adresata są kluczem wiadomości e-mail adresata. Przykład: {""mail@test.com:{"role":"signer","signaturePositions":[{"page":0,"x":0.55,"y":0.80,"width":0.25,"height":0.0.08}]}}. |
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
fastlaneProfileId
|
fastlaneProfileId | uuid |
Określ profil rozwiązania Fastlane, który ma być używany z tym dokumentem. (parametr useFastlane musi być ustawiony na wartość true). |
Zwraca
- Body
- EnvelopeResponse
Tworzenie żądania podpisu przy użyciu symboli zastępczych
Tworzy żądanie podpisu przy użyciu symboli zastępczych przechowywanych w przekazanym dokumencie. Adresaci i pozycje podpisów są wyodrębniane z dokumentu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
e-mail
|
True | string |
Adres e-mail nadawcy. Musi należeć do członka planu. |
|
|
firstName
|
firstName | True | string |
Imię nadawcy. |
|
lastName
|
lastName | string |
Nazwisko nadawcy. |
|
|
rola
|
role | string |
Rola nadawcy we wszystkich dokumentach. |
|
|
e-mail
|
string |
Adres e-mail odbiorcy. |
||
|
firstName
|
firstName | string |
Imię odbiorcy. |
|
|
lastName
|
lastName | string |
Nazwisko odbiorcy. |
|
|
doNotSendEmails
|
doNotSendEmails | boolean |
Jeśli ustawiono |
|
|
customId
|
customId | string |
Do użycia tylko wtedy, gdy adres e-mail adresata jest nieznany w momencie zapraszania. Działa to tylko wtedy, gdy zapraszasz adresatów (nie do przygotowywania tras) i chcesz użyć funkcji fastlane. Element Uwaga: identyfikator customId może służyć tylko do kompilowania linku odbiorcy do dokumentu. Nie można go używać dla innych żądań zamiast identyfikatora memberId. Aby uzyskać szczegółowe informacje na temat budowy adresu URL, zobacz Otwieranie dokumentu przy użyciu identyfikatora niestandardowego |
|
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
phoneNumber
|
phoneNumber | string |
Numer telefonu tego adresata. Jest to używane do weryfikacji wiadomości SMS. (np. +43 699 1234 1234). |
|
|
privateMessage
|
privateMessage | string |
Prywatna wiadomość dla tego konkretnego adresata. |
|
|
inPersonMode
|
inPersonMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie musiał podpisać dokument osobiście i nie zostanie wysłana żadna wiadomość e-mail. Ten tryb jest dostępny tylko przy użyciu typu podpisu SES |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "qualifiedPlusIdent", "simple" |
|
|
oznaczyć
|
tag | string |
Ten tag określa dostawcę tożsamości, który będzie używany do procesu podpisywania. Wybierz spośród wstępnie zdefiniowanego zestawu obsługiwanych dostawców.
Uwaga2: W przypadku używania |
|
|
canChange
|
canChange | boolean |
Wartość logiczna określająca, czy zaproszony odbiorca powinien mieć możliwość zmiany dostawcy podpisu |
|
|
country
|
country | string |
Domyślny kraj, jeśli jest pusty dla wszystkich, zostanie zwrócony błąd z wybranym tagiem dostawcy |
|
|
data ukończenia
|
dueDate | YYYY-MM-DD |
Data podpisania dokumentu. Ta data ukończenia jest wyświetlana adresatowi w wiadomości e-mail z zaproszeniem i jest również widoczna w sekcji szczegółów dokumentu pulpitu nawigacyjnego. Służy jako termin ukończenia procesu podpisywania. |
|
|
reminderInterval
|
reminderInterval | number |
Określa liczbę dni między wiadomościami e-mail z przypomnieniami. |
|
|
startSendingReminders
|
startSendingReminders | YYYY-MM-DD HH:MM |
Data wysłania przypomnień |
|
|
inviteLanguage
|
inviteLanguage | string |
Określa język wiadomości e-mail wysyłanych do anonimowych użytkowników, którzy nie mają konta. W przypadku użytkowników z kontem zostanie użyty język wybrany w swoim profilu. |
|
|
komunikat
|
message | string |
Wiadomość niestandardowa wysłana do adresatów w wiadomości e-mail. |
|
|
subject
|
subject | string |
Wiersz tematu wiadomości e-mail wysłanej do adresatów. |
|
|
sendOutFinishedPdf
|
sendOutFinishedPdf | boolean |
Jeśli ustawiono wartość true, plik PDF zostanie wysłany jako załącznik do wszystkich adresatów dokumentu (jeśli jest mniejszy niż 5 MB). |
|
|
focusedSigningMode
|
focusedSigningMode | boolean |
Po włączeniu tej opcji adresat żądania podpisu będzie ograniczony do podpisywania lub odrzucania dokumentu i nie będzie mógł przejść z dala od strony. |
|
|
allowForwarding
|
allowForwarding | boolean |
Zezwalaj na przekazywanie zaproszenia. |
|
|
collabSigningMode
|
collabSigningMode | object |
Obiekt, w którym każdy klucz reprezentuje rundę podpisywania, a jego odpowiadająca wartość wskazuje, czy podpisywanie współpracy jest włączone dla tej rundy. Jeśli wartość ma wartość true, wymagany jest tylko jeden podpis, aby ukończyć określoną rundę podpisywania i przejść do następnej rundy. Na przykład { "1": true } oznacza, że w rundzie podpisywania "1" wymagany jest tylko jeden podpis. |
|
|
inPersonSigning
|
inPersonSigning | boolean |
Jeśli to prawda, odbiorca otrzymuje wyskakujące okienko, w którym musi ręcznie narysować podpis |
|
|
folderName
|
folderName | string |
Jeśli zostanie podana, zostanie utworzona koperta zawierająca wszystkie dokumenty w dokumencieDataArray. (Wymagane w przypadku wysłania więcej niż jednego dokumentu) |
|
|
callbackUrl (adres URL wywołania zwrotnego)
|
callbackUrl | string |
Żądanie POST, w tym dokument, zostanie wysłane do tego adresu URL po utworzeniu nowego podpisu lub odrzuceniu dokumentu przez adresata. W przypadku awarii istnieje mechanizm ponawiania prób, aby upewnić się, że żądanie zostanie ponowione. |
|
|
Returnurl
|
returnUrl | string |
Link przycisku powrotu po podpisaniu dokumentu |
|
|
returnBtnText
|
returnBtnText | string |
Tekst przycisku powrotu po podpisaniu dokumentu |
|
|
dane
|
data | True | string |
Dane dokumentu (PDF lub DOCX) w formacie base64. |
|
mimetype
|
mimetype | string |
Typ MIME zakodowanych danych base64 PDF lub DOCX, wymagany, jeśli dokument nie jest plikiem PDF |
|
|
fileName
|
fileName | True | string |
Nazwa pliku |
|
etykieta
|
label | string |
Etykieta niestandardowa, którą można wysłać w celu organizowania dokumentów. |
|
|
page
|
page | True | integer |
Liczba stron, na których znajduje się pole, a pierwsza strona wynosi 0. |
|
Pagewidth
|
pageWidth | number |
Dowolna wartość całkowita opisująca szerokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 478 jako wartość domyślną. |
|
|
Pageheight
|
pageHeight | number |
Dowolna wartość całkowita opisująca wysokość strony. Większa liczba, tym większa precyzja podczas pozycjonowania pola w x y spacji. Na stronie A4 mamy 676 jako wartość domyślną. |
|
|
x
|
x | True | float |
Reprezentuje położenie poziome pola jako procent szerokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest ustawione na 10% szerokości strony po lewej stronie. |
|
y
|
y | True | float |
Przedstawia położenie pola w pionie jako procent wysokości strony. Źródło (0,0) znajduje się w lewym górnym rogu strony. Wartość 0,1 oznacza, że pole jest umieszczone na 10% wysokości strony od góry. |
|
width
|
width | True | float |
Szerokość pola na podstawie wymiarów strony, podobnie jak współrzędne x i y. Jest to zmiennoprzecinkowa reprezentująca procent stronyWidth. |
|
height
|
height | True | float |
Wysokość pola na podstawie wymiarów strony, podobnie jak współrzędnych x i y. Jest to zmiennoprzecinkowy reprezentujący procent stronyHeight. |
|
id
|
id | True | string |
Unikatowy identyfikator tego pola wygenerowany w dowolny sposób. |
|
etykieta
|
label | string |
Tekst zastępczy, taki jak nazwa pola, np. "Data urodzenia". |
|
|
value
|
value | string |
Wartość domyślna pola. Może mieć wartość null. Jeśli pole ma typ "chooseBox", wartość może mieć wartość null lub jeden z ciągów zdefiniowanych w opcjach. |
|
|
identyfikator pola
|
fieldId | string |
Stabilny identyfikator pola skonfigurowany w interfejsie użytkownika. Służy do wstępnego wypełniania pól formularza przepływu pracy za pośrednictwem żądań interfejsu API. |
|
|
tylko do odczytu
|
readonly | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może zmodyfikować wartości tego pola. |
|
|
required
|
required | boolean |
Jeśli ustawiono wartość true, zaproszona osoba nie może podpisać dokumentu bez wypełniania tego pola. |
|
|
typ
|
type | True | string | |
|
wielowierszowy
|
multiline | boolean |
Określa, czy wiele wierszy jest dozwolonych. |
|
|
displayValue
|
displayValue | True | string | |
|
exportValue
|
exportValue | True | string | |
|
grupa
|
group | number |
Każde pole radiowe można przypisać do grupy. |
|
|
signatureTypes
|
signatureTypes | array of string |
Typ podpisu dozwolony dla tego dokumentu może zostać zastąpiony przez typ podpisu adresata. Obsługiwana jest co najwyżej jedna wartość. Opcje: "advanced", "advancedPlus", "qualified", "simple", "qualifiedPlusIdent" |
|
|
identyfikator refId
|
refId | string |
Identyfikator refId jest opcjonalnym polem używanym do krzyżowego odwoływanie się do przekazanego dokumentu. Jeśli zostanie podana, umożliwia przypisanie niestandardowego identyfikatora odwołania do dokumentu, który zostanie zwrócony jako część obiektu dokumentu w przyszłych odpowiedziach interfejsu API. Może to być przydatne do śledzenia lub organizowania dokumentów przez system zewnętrzny lub przepływ pracy. |
|
|
język
|
language | string |
Język dokumentów. |
|
|
folderId
|
folderId | string |
Identyfikator folderu, do którego należy wstawić dokumenty. Jest to możliwe tylko wtedy, gdy zarówno inviteData, jak i folderName są niezdefiniowane. |
|
|
isAttachment
|
isAttachment | boolean |
Usługa isAttachment nie jest wymagana w tym przypadku. |
|
|
useFastlane
|
useFastlane | boolean |
Jeśli jest ustawiona |
|
|
fastlaneProfileId
|
fastlaneProfileId | uuid |
Określ profil rozwiązania Fastlane, który ma być używany z tym dokumentem. (parametr useFastlane musi być ustawiony na wartość true). |
Zwraca
- Body
- EnvelopeResponse
Usuwanie dokumentu
Usuwa dokument lub usuwa do niego dostęp członka, w zależności od tego, czy podany memberId element należy do nadawcy, czy adresata oraz czy dokument jest częścią koperty.
Dokumenty w kopercie
Parametr all zapytania nie ma wpływu na dokumenty w kopercie.
Za pomocą nadawcy memberId:
- Pojedynczy dokument jest usuwany dla nadawcy i wszystkich adresatów.
- Dokument jest usuwany z koperty.
Za pomocą adresata memberId:
- Wszystkie dokumenty w kopercie są usuwane dla adresata.
- Odbiorca jest oznaczony jako
declinedwe wszystkich dokumentach, które zostały usunięte dla adresata. - Dokumenty pozostają dostępne dla wszystkich pozostałych członków w dokumencie.
Pojedyncze dokumenty
Za pomocą nadawcy memberId i all=true:
- Dokument zostanie usunięty dla nadawcy i wszystkich adresatów.
Za pomocą nadawcy memberId i all=false:
- Dokument jest usuwany tylko dla nadawcy.
- Dokument pozostaje dostępny dla innych adresatów dokumentu.
Za pomocą adresata memberId:
- Odbiorca jest oznaczony jako
declinedw dokumencie. - Dokument pozostaje dostępny dla wszystkich pozostałych członków w dokumencie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator elementu członkowskiego
|
memberId | True | string |
Identyfikator elementu członkowskiego |
|
Usuń dla wszystkich adresatów
|
all | boolean |
Dotyczy tylko pojedynczych dokumentów, gdy podany |
Zwraca
- response
- DeleteDocumentResponse
Uzyskiwanie stanu żądania
Uzyskaj stan żądania podpisu. Zwraca obiekt JSON dokumentu lub błąd. Parametr jest zwracany przez żądanie pocztowe w dokumencie i jest skojarzony z wiadomością e-mail nadawców.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator elementu członkowskiego
|
memberId | True | string |
Identyfikator elementu członkowskiego |
Zwraca
Definicje
DeleteDocumentResponse
- Usuń odpowiedź na dokument
- string
_DocumentListResponse
Obiekt odpowiedzi dla operacji listy dokumentów
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
dane
|
data | array of _Document |
Lista dokumentów |
|
Obiekt stronicowania
|
pagination | _PaginationObject |
_PaginationObject
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
łączny
|
total | integer |
Całkowita liczba elementów (np. dokumentów) w widoku (np. allDocuments) |
|
lastPage
|
lastPage | integer |
Liczba ostatniej strony |
|
perPage
|
perPage | integer |
Liczba dokumentów na stronę |
|
Currentpage
|
currentPage | integer |
Liczba bieżącej strony |
|
to
|
to | integer |
Indeks ostatniego dokumentu |
_Document
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
nazwa
|
name | string |
Nazwa dokumentu |
|
id
|
id | string |
Identyfikator dokumentu |
|
updatedAt
|
updatedAt | date |
Data ostatniej aktualizacji dokumentu |
|
createdAt
|
createdAt | date |
Data utworzenia dokumentu |
|
signaturesTypes
|
signaturesTypes | array of string |
Typy podpisów dozwolonych dla tego adresata mogą zostać zastąpione przez typy podpisów adresatów. Opcje: ["advanced", "advancedPlus", "qualified", "simple",'qualifiedPlusIdent'] |
|
callbackUrl (adres URL wywołania zwrotnego)
|
callbackUrl | string |
Żądanie ogłaszania zawierające dokument zostanie wysłane do tego adresu URL po utworzeniu nowego podpisu |
|
Returnurl
|
returnUrl | string |
Link przycisku powrotu po podpisaniu dokumentu |
|
returnBtnText
|
returnBtnText | string |
Tekst przycisku powrotu po podpisaniu dokumentu |
|
inPersonSigning
|
inPersonSigning | boolean | |
|
signingRound
|
signingRound | number | |
|
stan
|
state | string |
Bieżący stan dokumentu. Możliwe wartości to: wersja robocza, oczekująca, odrzucona, ukończona, załącznik, ręczniePending, ręcznieUpełnianie |
|
element członkowski
|
member |
Zazwyczaj właściciel dokumentu, ale jeśli używasz metody getSignatureStatus, element członkowski będzie identyfikatorem podanym w żądaniu |
|
|
members
|
members | array of DocumentListMember |
Lista zaproszonych kontaktów |
|
Pola
|
boxes | array of DocumentListResponseBox |
Dane pozycji podpisu z dodatkowymi polami specyficznymi dla odpowiedzi. Pola cardStyle, pageWidth i pageHeight są opcjonalne i mogą nie być obecne we wszystkich odpowiedziach interfejsu API. |
|
identyfikator refId
|
refId | string | |
|
allSignersSigned
|
allSignersSigned | boolean | |
|
allMembersSigned
|
allMembersSigned | boolean | |
|
focusedSigningMode
|
focusedSigningMode | boolean |
DocumentListResponseBox
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
identyfikator pola
|
fieldId | string |
Skonfigurowany identyfikator pola używany do wstępnego wypełniania pól formularza. Zwraca wartość null, jeśli nie skonfigurowano identyfikatora pola. |
|
typ
|
type | string | |
|
value
|
value |
Wartość pola pola. Może być ciągiem (w tym pustym ciągiem), wartością logiczną lub wartością null w zależności od typu pola. |
|
|
etykieta
|
label | string | |
|
readOnly
|
readOnly | boolean |
DocumentListMember
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
Identyfikator elementu członkowskiego może służyć do otwierania dokumentu w edytorze niezawodnych podpisów. Bardziej szczegółowy opis można znaleźć tutaj |
|
e-mail
|
string |
Adres e-mail właściciela dokumentu |
|
|
firstName
|
firstName | string |
Imię właściciela dokumentu |
|
lastName
|
lastName | string |
Nazwisko właściciela dokumentu |
|
lastActivityAt
|
lastActivityAt | date-time |
Data i godzina ostatniego działania (ciąg daty i godziny iso 8601) |
|
createdAt
|
createdAt | date-time |
Data i godzina przekazania dokumentu (ciąg daty i godziny iso 8601) |
|
Podpisane
|
signed | boolean |
Wskazuje, czy dokument został podpisany przez właściciela |
|
isAdmin (Administrator Systemu)
|
isAdmin | boolean |
Wskazuje, czy członek ma stan administratora |
|
isSigner
|
isSigner | boolean |
Wskazuje, czy element członkowski jest sygnatariuszem |
|
isApprover
|
isApprover | boolean |
Wskazuje, czy element członkowski jest osobą zatwierdzającą |
|
isViewer
|
isViewer | boolean |
Wskazuje, czy element członkowski jest przeglądarką |
|
approvedAt
|
approvedAt | date-time |
Tylko wtedy, gdy wartość isApprover ma wartość true. Data i godzina zatwierdzenia elementu członkowskiego (ciąg daty i godziny ISO 8601) |
|
viewedAt
|
viewedAt | date-time |
Tylko wtedy, gdy program isViewer ma wartość true. Data i godzina wyświetlenia dokumentu przez członka (ciąg daty i godziny ISO 8601) |
|
signaturePosition
|
signaturePosition |
Pozycje podpisu dla tego elementu członkowskiego. Na podstawie tego, co jest wysyłane w żądaniu, można oczekiwać pojedynczego obiektu położenia lub tablicy obiektów położenia. |
|
|
signedAt
|
signedAt | date-time |
Data i godzina podpisu (ciąg daty/godziny ISO 8601) |
|
signingOrder
|
signingOrder | number |
Kolejność podpisywania tego elementu członkowskiego |
|
odrzuconeAt
|
declinedAt | date-time |
Data i godzina odrzucenia elementu członkowskiego (ciąg daty i godziny ISO 8601) |
|
Podpisów
|
signatures | array of object |
Tablica podpisów |
|
signatureType
|
signatures.signatureType | string |
Typ podpisu (np. aes_sproof) |
|
signedAt
|
signatures.signedAt | date-time |
Sygnatura czasowa stosowania podpisu (ciąg daty/godziny ISO 8601) |
PrepareSignatureRequestResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
folderId
|
folderId | string | |
|
folderName
|
folderName | string | |
|
Dokumenty
|
documents | array of object | |
|
id
|
documents.id | string | |
|
nazwa
|
documents.name | string | |
|
język
|
documents.language | string | |
|
members
|
documents.members | array of |
Ponieważ jest to odpowiedź na żądanie przygotowania podpisu, tablica elementów członkowskich będzie pusta. Dzieje się tak, ponieważ członkowie nie są jeszcze zapraszani. |
|
element członkowski
|
documents.member | MemberResponseSchema |
MemberResponseSchema
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
documentId
|
documentId | string | |
|
e-mail
|
string | ||
|
firstName
|
firstName | string | |
|
lastName
|
lastName | string | |
|
isAdmin (Administrator Systemu)
|
isAdmin | boolean | |
|
createdAt
|
createdAt | date-time |
Data i godzina utworzenia elementu członkowskiego (ciąg daty i godziny ISO 8601) |
|
sentDeleteNotificationAt
|
sentDeleteNotificationAt | date-time |
Data i godzina wysłania powiadomienia o usunięciu (ciąg daty i godziny ISO 8601) |
|
manuallyLastEmailSent
|
manuallyLastEmailSent | date-time |
Data i godzina wysłania ostatniej ręcznej wiadomości e-mail (ciąg daty i godziny ISO 8601) |
|
signaturePosition
|
signaturePosition | MemberSignaturePositionResponse |
Dane pozycji podpisu z dodatkowymi polami specyficznymi dla odpowiedzi. Pola cardStyle, pageWidth i pageHeight są opcjonalne i mogą nie być obecne we wszystkich odpowiedziach interfejsu API. |
|
doNotSendEmails
|
doNotSendEmails | boolean | |
|
odrzuconeAt
|
declinedAt | date-time |
Data i godzina odrzucenia elementu członkowskiego (ciąg daty i godziny ISO 8601) |
|
signingOrder
|
signingOrder | number | |
|
Ondemand
|
onDemand | string | |
|
recipientId
|
recipientId | string | |
|
signatureTypes
|
signatureTypes | array of string | |
|
signatureTypesActive
|
signatureTypesActive | boolean | |
|
privateMessage
|
privateMessage | string | |
|
customId
|
customId | string | |
|
useFastlane
|
useFastlane | boolean | |
|
rola
|
role | string | |
|
approvedAt
|
approvedAt | date-time |
Data i godzina zatwierdzenia elementu członkowskiego (ciąg daty i godziny ISO 8601) |
|
verificationConfig (konfiguracja weryfikacji)
|
verificationConfig | ||
|
phoneNumber
|
phoneNumber | string | |
|
Podpisów
|
signatures | array of string | |
|
Pola
|
boxes | array of DocumentResponseBox |
Pola pól formularza przypisane do tego elementu członkowskiego. |
|
signedAt
|
signedAt | date-time |
Data i godzina podpisania elementu członkowskiego (ciąg daty i godziny ISO 8601) |
DocumentResponseBox
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
identyfikator pola
|
fieldId | string |
Skonfigurowany identyfikator pola używany do wstępnego wypełniania pól formularza. Zwraca wartość null, jeśli nie skonfigurowano identyfikatora pola. |
|
typ
|
type | string | |
|
value
|
value | string |
Wartość pola pola. Może być ciągiem (w tym pustym ciągiem), wartością logiczną lub wartością null w zależności od typu pola. |
|
etykieta
|
label | string | |
|
readOnly
|
readOnly | boolean |
MemberSignaturePositionResponse
Dane pozycji podpisu z dodatkowymi polami specyficznymi dla odpowiedzi. Pola cardStyle, pageWidth i pageHeight są opcjonalne i mogą nie być obecne we wszystkich odpowiedziach interfejsu API.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Przedmioty
|
SignaturePositionResponse |
Dane pozycji podpisu z dodatkowymi polami specyficznymi dla odpowiedzi. Pola cardStyle, pageWidth i pageHeight są opcjonalne i mogą nie być obecne we wszystkich odpowiedziach interfejsu API. |
SignaturePositionResponse
Dane pozycji podpisu z dodatkowymi polami specyficznymi dla odpowiedzi. Pola cardStyle, pageWidth i pageHeight są opcjonalne i mogą nie być obecne we wszystkich odpowiedziach interfejsu API.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
page
|
page | integer |
Numer strony, zaczynając od 0. |
|
x
|
x | number |
x współrzędna lewej górnej pozycji podpisów |
|
y
|
y | number |
współrzędna lewej górnej pozycji podpisów |
|
width
|
width | number |
Szerokość podpisu. |
|
height
|
height | number |
Wysokość podpisu. |
|
cardStyle
|
cardStyle | string |
Styl wizualny karty podpisu. To pole jest opcjonalne i może nie zostać zwrócone we wszystkich odpowiedziach. |
|
Pagewidth
|
pageWidth | number |
Szerokość strony w pikselach. To pole jest opcjonalne i może nie zostać zwrócone we wszystkich odpowiedziach. |
|
Pageheight
|
pageHeight | number |
Wysokość strony w pikselach. To pole jest opcjonalne i może nie zostać zwrócone we wszystkich odpowiedziach. |
KopertaResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
folderId
|
folderId | string | |
|
folderName
|
folderName | string | |
|
Dokumenty
|
documents | array of object | |
|
id
|
documents.id | string | |
|
nazwa
|
documents.name | string | |
|
język
|
documents.language | string | |
|
startSendingReminders
|
documents.startSendingReminders | date-time |
Data i godzina rozpoczęcia wysyłania przypomnień (ciąg daty i godziny ISO 8601) |
|
sendReminder
|
documents.sendReminder | boolean | |
|
reminderSent
|
documents.reminderSent | boolean | |
|
reminderInterval
|
documents.reminderInterval | number | |
|
createdAt
|
documents.createdAt | date-time |
Data i godzina utworzenia dokumentu (ciąg daty i godziny ISO 8601) |
|
callbackUrl (adres URL wywołania zwrotnego)
|
documents.callbackUrl | string | |
|
Returnurl
|
documents.returnUrl | string | |
|
returnBtnText
|
documents.returnBtnText | string | |
|
inPersonSigning
|
documents.inPersonSigning | boolean | |
|
signingRound
|
documents.signingRound | number | |
|
isTemplate
|
documents.isTemplate | boolean | |
|
templateId
|
documents.templateId | string | |
|
linkId
|
documents.linkId | string | |
|
linkExpiresAt
|
documents.linkExpiresAt | string | |
|
pochodneFromLink
|
documents.derivedFromLink | boolean | |
|
stan
|
documents.state | string | |
|
complianceLevel
|
documents.complianceLevel | string | |
|
allowForwarding
|
documents.allowForwarding | boolean | |
|
linkExpires
|
documents.linkExpires | boolean | |
|
setDueDate
|
documents.setDueDate | boolean | |
|
data ukończenia
|
documents.dueDate | date-time |
Data ukończenia dokumentu (ciąg daty/godziny ISO 8601) |
|
focusedSigningMode
|
documents.focusedSigningMode | boolean | |
|
linkMaxSignaturesEnabled
|
documents.linkMaxSignaturesEnabled | boolean | |
|
linkMaxSignatures
|
documents.linkMaxSignatures | number | |
|
fastlaneProfileId
|
documents.fastlaneProfileId | string | |
|
identyfikator refId
|
documents.refId | string | |
|
sendOutFinishedPdf
|
documents.sendOutFinishedPdf | boolean | |
|
signatureTypes
|
documents.signatureTypes | array of string | |
|
members
|
documents.members | array of MemberResponseSchema | |
|
element członkowski
|
documents.member | MemberResponseSchema | |
|
Pola
|
documents.boxes | array of DocumentResponseBox |
Pola pól formularza ogólnego, które nie są przypisane do określonego adresata zwrócone, jeśli dokument ma pola formularza. Pola przypisane do adresatów są zwracane w polach członkowskich[n].box. |
|
zaległy
|
documents.overdue | boolean |
DocumentStatusForFlow
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
nazwa
|
name | string | |
|
stan
|
state | string |
Bieżący stan dokumentu. Możliwe wartości to: wersja robocza, oczekująca, odrzucona, ukończona, załącznik, ręczniePending, ręcznieUpełnianie |
|
createdAt
|
createdAt | date | |
|
updatedAt
|
updatedAt | date | |
|
allSignersSigned
|
allSignersSigned | boolean | |
|
allMembersSigned
|
allMembersSigned | boolean | |
|
focusedSigningMode
|
focusedSigningMode | boolean |