authorization_invalid_request ошибка при подготовке конверта DocuSign для изменения вкладки

Question

Я пытаюсь создать черновик конверта из шаблона, а затем изменить некоторые вкладки в шаблоне. Я получаю ответ AUTHORIZATION_INVALID_REQUEST.

Мой первоначальный запрос по следующему адресу https://demo.docusign.net/restapi/v2/accounts/<account id>/envelopes

и полезная нагрузка следующим образом:

{ 
    "status": "created", 
    "emailSubject": "2015-01-27T16:25:43.133-05:00 Docusign Template Request", 
    "emailBlurb": "email blurb", 
    "templateId": "<template id>", 
    "brandId": "<brand id>", 
    "templateRoles": [ 
    { 
     "name": "<name>", 
     "email": "<email>", 
     "roleName": "<role>", 
     "clientUserId": "", 
     "emailNotification": { 
     "supportedLanguage": "en", 
     "emailSubject": "<subject>", 
     "emailBody": "special email body" 
     } 
    } 
    ], 
    "allowReassign": "true", 
    "enableWetSign": "false", 
    "messageLock": "false" 
} 

Это дает следующий ответ:

{ 
    "envelopeId": "<envelope id>", 
    "uri": "/envelopes/<envelope id>", 
    "statusDateTime": "2015-01-28T22:09:43.9770000Z", 
    "status": "created" 
} 

Затем я посылаю взгляд получателя запросите по следующему адресу: https://demo.docusign.net/restapi/v2/envelopes/<envelope id>/views/recipient, используя идентификатор конверта, полученный в вышеуказанном ответе.

Это приводит следующий ответ:

{ 
    "errorCode": "AUTHORIZATION_INVALID_REQUEST", 
    "message": "The authorization request is malformed." 
} 

Заметим, что если я установил первый запрос выше в статусе «отправлен» (и, таким образом, сделал не создать проект конверт), второй запрос был бы успешным.

Однако, согласно документации DocuSign (стр. 163 руководства по API), API-интерфейс API-интерфейсов изменений изменяет одну или несколько вкладок для получателя в черновик конверта. Соответственно, чтобы выполнить модификацию вкладки, мне нужен черновик конверта, а не отправленный. Но когда я создаю черновик конверта, вызов views/recipient завершается неудачно, как указано выше.

Я могу добавить вкладки успешно в «отправленный» конверт. Но я предпочел бы внести изменения вкладки, и у меня возникли проблемы с этим.

Answer 1

Вы не используете действительную конечную точку DocuSign. Откуда у вас был URL-адрес /v2/envelopes/<envelope id>/views/recipient? Это не правильный URL, поэтому сообщение об ошибке вы получаете.

После создания конверта, если вы хотите изменить вкладки заданного получателя, то вам необходимо сделать следующий API вызова:

Modify Tabs for Recipient

Заметьте, что это PUT вызов не POST, и URI является:

/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs 

Например, если вы хотите изменить вкладки для получателя, который является recipientId = 3 вы бы сделать вызов, аналогичный (обратите внимание на 3 в URL):

PUT https://demo.docusign.net/restapi/v2/accounts/12345/envelopes/{envelopeId}/ 
recipients/3/tabs 

X-DocuSign-Authentication: <DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials> 
Accept: application/json 
Content-Type: application/json 
{ 
    "approveTabs":[{ 
     <Tab information removed> 
    }], 
    "titleTabs":[{ 
     <Tab information removed> 
    }], 
    "signHereTabs":[{ 
     <Tab information removed> 
    }] 
} 

Answer 2

Я не уверен, что это квалифицируется как «ответ» на мой вопрос, но, похоже, проблема была как-то решена. Я отпустил это на пару дней, пока я занимался другими вопросами, а затем вчера днем ​​вдруг начал работать, без изменений с моей стороны. Конкретная часть, которая не работала, пыталась выполнить PUT на конверте, чтобы изменить теги. Это не должно работать, если конверт не является черновиком; мои конверты были сквозными. Не работала пару дней назад, и теперь это так. @Pete и @Dorian: вы можете попробовать снова, если вы еще этого не сделали; если вы не делаете ничего другого, это может сработать сейчас.