REST API - Изглед на получател - Как да конфигурирате множество returnUrl за събитие

Опитвам се да създам вградено подписване с моята интеграция чрез REST API. Мога успешно да създам токена с минималните изисквания.

{ "userName": "Derrick Test", "email": "[email protected]", "recipientId": "1", "clientUserId": "1", "returnUrl": "http://www.google.com", "authenticationMethod": "имейл" }

Това, което бих искал да подобря, е пренасочване на моите подписващи към конкретен URL адрес при нещо повече от просто завършване. По-конкретно бих искал да конфигурирам различен URL за събитията:

отмени откажи signing_complete viewing_complete

REST документацията не предоставя JSON пример при използване на множество събития. Някой друг имал ли е успех с това?


docusignapi
person WTP API    schedule 12.02.2014    source източник

Отговори (1)


arrow_upward
2
arrow_downward

С REST API можете да предоставите само един returnUrl и той ще се прилага за всяко/всички събития (т.е. отмяна / отказ / изключение / fax_pending / id_check_failed / session_timeout / signing_complete / ttl_expired / viewing_complete) . Можете обаче да постигнете ефекта дестинацията на потребителя да зависи от събитието, просто като кодирате страницата си за връщане, за да оцените параметъра event в низа на заявката и незабавно направите друго пренасочване към страницата, специфична за събитието, в зависимост от стойността на параметъра event querystring.

Да приемем например, че сте посочили http://www.myfakesite.com/processReturn.aspx като стойност на returnUrl в заявката POST Recipient View. Когато получателят подпише документа(ите) и изпрати плика, DocuSign ще пренасочи потребителя към URL: http://www.myfakesite.com/processReturn.aspx?event=signing_complete. Ако приемем, че сте изградили „processReturn.aspx“, така че да оценява стойността на параметъра на низа на заявката event, той ще види стойност „signing_complete“ и след това незабавно ще пренасочи към подходящия страница (която посочвате в кода) за събитието Подписването е завършено.

Страница 167 (returnUrl описание на свойството) от ръководството за REST API (http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf) изброява всички възможни стойности за параметъра event.

person Kim Brandl    schedule 12.02.2014