Adobe EchoSign API v5 PHP sample


Adobe EchoSign API v5 PHP sample

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

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

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

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

require "../../../vendor/autoload.php"; 
use KevinEm'AdobeSign'AdobeSign;
use GuzzleHttp'Psr7;

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

$provider = new KevinEm'OAuth2'Client'AdobeSign([
'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 = Psr7'FnStream::decorate(Psr7'stream_for(file_get_contents($file_path)), [
      'getMetadata' => function() use ($file_path) {
          return $file_path;
      }
  ]);
  $multipart_stream   = new Psr7'MultipartStream([
      [
          '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' => 'orlando@yoursigner.com'
            ],
            'recipientSetRole'        => [
                'SIGNER'
            ]
        ],
        'mergeFieldInfo'    => [
            [
                'fieldName'    => 'Name',
                'defaultValue' => 'John Doe'
            ]
        ],
        'signatureFlow'     => 'SENDER_SIGNATURE_NOT_REQUIRED'
    ]
    ]);

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

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

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