Elementy webhook i cykl życia podpisu elektronicznego
Zweryfikowano wywołania zwrotne Dropbox Sign, dostarczanie idempotentne, zmiany statusu, opóźnione pobieranie i uzgadnianie niepewnych wysyłek.
Wywołania zwrotne zaufanego dostawcy#
Dropbox Sign wysyła dane formularza za pomocą pliku json pole. PDFHQ weryfikuje podstawowy klucz API HMAC na podstawie znacznika czasu/typu zdarzenia i HMAC Content-Sha256 w całym surowym formacie JSON. Opcjonalny skonfigurowany identyfikator aplikacji również musi być zgodny.
Punkt końcowy: POST /v1/esign/webhooks/dropbox-sign. Skonfiguruj ten adres URL tylko w aplikacji piaskownicy Dropbox Sign API. Nie ujawniaj poświadczeń dostawcy w przeglądarce ani w żądaniach API klienta.
Cykl życia i odzyskiwanie operacyjne#
Stany kopert to wersja robocza, wysyłka, wysłana, przeglądana, partially_signed, all_signed, do pobrania, archiwizacja, zarchiwizowana, odrzucona, anulowana, wygasła, nieudana i needs_reconciliation. Wywołania zwrotne zweryfikowanych dostawców mogą zostać dostarczone nieprawidłowo; aktualizacje nie mogą cofać się do stanu późniejszego ukończenia. Zduplikowane zdarzenia wywołania zwrotnego są utrwalane po użyciu unikalnego klucza zdarzenia.
Nie pobieraj z all_signed: Dropbox Sign może jeszcze przygotować plik. Poczekaj na wydarzenie do pobrania. Jeśli upłynie limit czasu testu POST dostawcy, nie twórz drugiego żądania podpisania, dopóki operator nie potwierdzi pierwotnego wyniku dostawcy.
Tylko konto i projekt API, który utworzył kopertę, może odczytać odbiorców, zarchiwizować dane wyjściowe lub uzyskać link do pobrania.
