Блог

Я использую Docusign REST API для создания конвертов, затем я вызываю метод POST Recipiental View для создания представления получателя.

В документации указано:

Для идентификации получателя можно использовать идентификатор пользователя или адрес электронной почты и имя пользователя. Если используется идентификатор пользователя и предоставляется идентификатор clientUserId, идентификатор пользователя должен соответствовать идентификатору получателя (который может быть получен с помощью вызова GET recipients) для конверта.

Я точно знаю, что имя пользователя может измениться, если пользователь вводит другое полное имя при принятии подписи, поэтому я предпочитаю userId. Как предложено в этой документации, я вызываю GET receivers сразу после создания конверта и сохраняю все идентификаторы пользователя guid.

Позже, когда получатель готов подписать, и я вызываю POST Recipient View, я отправляю идентификатор пользователя, который я сохранил ранее, и идентификатор clientUserId (потому что это встроенный получатель). В большинстве случаев это работает, но иногда я получаю сообщение об ошибке:

 {
"errorCode": "INVALID_REQUEST_PARAMETER",
"message": "The request contained at least one invalid parameter. A value was not found for parameter 'userName'."
}
  

Когда это произошло в первый раз, когда я вызвал GET Receivers для этого неудачного конверта, и я заметил, что идентификатор пользователя, который я записал при создании конверта, не соответствует текущему идентификатору пользователя.

Мой обходной путь — вызвать GET Recpients, получить текущий идентификатор пользователя и снова вызвать POST Recipient View . Это не идеально.

Вопросы / комментарии:

• Изменяется ли идентификатор пользователя в течение срока службы конверта?
• Как лучше всего получить правильный идентификатор пользователя? Получить его после создания конверта? Правильно ли это перед созданием представления получателя?
• Было бы здорово, если бы API возвращал идентификаторы пользователей в ответ, возвращаемый при создании конверта.