forward-force / right-signature-api-sdk
RightSignature API 的 PHP 封装
1.0.2
2022-03-28 15:30 UTC
Requires
- php: ^7.4|^8.0
- ext-json: *
- guzzlehttp/guzzle: ^7.0.1
Requires (Dev)
- phpmd/phpmd: ^2.9
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3.5
- vimeo/psalm: ^4.5
This package is auto-updated.
Last update: 2024-08-28 23:50:05 UTC
README
安装
使用 composer 安装,如下所示
composer require forward-force/rightSignature-api-sdk
用法
身份验证
为了进行身份验证,您需要传递如下所示的 私有 API 令牌
$rightSignature = new RightSignature($token); //pv_deec47538d80245234a66e1d14d38be81
示例
获取所有文档
$rightSignature = new RightSignature($token); try { $documents = $rightSignature->documents()->fetch(); var_dump($documents); } catch (GuzzleException $e) { var_dump($e->getMessage()); }
通过 ID 获取文档
$document = $rightSignature->documents()->getById('fcc2517e-c596-4d91-9f59-112a292eb643');
克隆模板,准备模板(填充合并字段),并发送给签字者
$signer1 = ['name' => 'buyer_signer', 'signer_email' => 'foo@example.com', 'signer_name' => 'John Doe']; $signer2 = ['name' => 'seller_signer', 'signer_email' => 'bar@example.com', 'signer_name' => 'Jane Smith']; $document = $rightSignature->documents() ->addBodyParameter('roles', [$signer1, $signer2]) ->addBodyParameter('reusable_template', [ 'roles' => [$signer1, $signer2] ]) ->addBodyParameter("message", "Please sign this") ->addBodyParameter('name', 'Name 1') ->addMergeField('client_name', 'The Client') ->sendDocument('fcc2517e-c596-4d91-9f59-112a292eb643');
获取所有可重用模板
try { $documents = $rightSignature->documents()->fetchReusableTemplates(); var_dump($documents); } catch (GuzzleException $e) { var_dump($e->getMessage()); }
通过 ID 获取可重用模板
$document = $rightSignature->documents()->getReusableTemplateById('fcc2517e-c596-4d91-9f59-112a292eb643');
贡献
要本地运行,您可以使用此处提供的 docker 容器。您可以这样运行它
docker-compose up
有关在本地运行此库的自动生成文档,请参阅 phpdocker/README.md
如果您发现问题、有疑问或建议,请随时在 github 上提交问题。
致谢
感谢 phpdocker.io 使获取 PHP 环境变得如此简单!