Adobe EchoSign API v5 PHP sample

Question

如何使用Adobe EchoSign API v5向某人发送用于签名的文档？对于API版本5，我只能找到一个使用Java的示例。但我需要它在PHP中。如果我使用任何早期版本，它需要一个"API密钥"，但在当前版本的API中，我找不到我的API密钥。我甚至在PHP中找不到任何示例代码。

Answer 1

当前版本中不再有API密钥，因为它现在使用"访问令牌"。这就是我在PHP应用程序上所做的。

1. 存储应用程序ID和客户端机密，并将其用于请求访问令牌
2. 如果请求成功，请将访问令牌和刷新令牌以及时间戳存储在数据库中
3. 访问令牌将在1小时后过期，因此您必须检查它是否已经过期
4. 如果访问令牌已过期。请求刷新令牌，它应该返回一个新的访问令牌
5. 将您存储的访问令牌替换为您接收的新令牌，并重新获得对API的访问权限

Answer 2

我花了一段时间，但在安装composer后，我让它正常工作，我希望它能帮助其他人(https://github.com/kevinem/adobe-sign-php/)你需要创建你的沙箱页面，对我来说，这是一个在/vvendor/kevinem/adobe-sign-php/中的index.php，然后在我的情况下，你需要包括2个类AdobeSign和Psr7，因为我需要上传2个文档摘要。

require "../../../vendor/autoload.php"; 
use KevinEmAdobeSignAdobeSign;
use GuzzleHttpPsr7;

这就是我配置$provider的方式，回调URL必须与adobe后端的相同，并且我在AdobeSign.php 中手动更改了数据中心

$provider = new KevinEmOAuth2ClientAdobeSign([
'clientId'          => 'YOUR_APP_ID',
'clientSecret'      => 'YOUR_APP_SECRET',
'redirectUri'       => 'YOUR_BACK_URL', 
'dataCenter'        => 'secure.na2', 
'scope'             => ['user_login:self',
                      'agreement_write:self',
                      'widget_write:self',
                      'library_write:self',
                      'agreement_send:self'
                      ]
 ]);

然后你需要创建一个数组，其中包含所有.pdf文档的URL。我叫$archivos。

$accessToken = $adobeSign->getAccessToken($_GET['code']);
$adobeSign->setAccessToken($accessToken->getToken());
$todosDoc = array();
foreach ($archivos as $doc) {
  $file_path = __DIR__.$doc;
  $file_stream = Psr7FnStream::decorate(Psr7stream_for(file_get_contents($file_path)), [
      'getMetadata' => function() use ($file_path) {
          return $file_path;
      }
  ]);
  $multipart_stream   = new Psr7MultipartStream([
      [
          'name'     => 'File',
          'contents' => $file_stream
      ]
  ]);
  $transient_document = $adobeSign->uploadTransientDocument($multipart_stream);
  array_push($todosDoc, $transient_document);
}
$adobeSign->createAgreement([
    'documentCreationInfo' => [
        'fileInfos'         => $todosDoc,
        'name'              => 'My Document Test',
        'signatureType'     => 'ESIGN',
        'recipientSetInfos' => [
            'recipientSetMemberInfos' => [
                'email' => '[e-mail]'
            ],
            'recipientSetRole'        => [
                'SIGNER'
            ]
        ],
        'mergeFieldInfo'    => [
            [
                'fieldName'    => 'Name',
                'defaultValue' => 'John Doe'
            ]
        ],
        'signatureFlow'     => 'SENDER_SIGNATURE_NOT_REQUIRED'
    ]
    ]);

Answer 3

Adobe Sign已经改变了其身份验证过程，现在它不再使用"API密钥"，而是使用更安全的"访问令牌"。

您可以使用任何基于PHP的第三部分其余API客户端库进行Adobe Sign API调用，直到Adobe Sign本身提供用于PHP的SDK为止。

Answer 4

Adobe eSign现在使用oAuth进行身份验证，并且针对不同的语言有很多不同的库