README

Mekari 提供的 eMaterai 非官方 Laravel 库

这是 Mekari 提供的 eMaterai API 非官方库，如需官方文档，请访问 Mekari

1. 安装

使用 Composer CLI 安装：composer require gandhist/ematerai

2. 如何使用

2.1 通用设置

添加到您的环境变量中

    MATERAI_CLIENT_ID=<your client id>
    MATERAI_SECRET=<your client_secret>
    MATERAI_CODE=<your_auth_code>
    MATERAI_IS_PRODUCTION=false

添加 use Gandhist\Ematerai\Config;，设置配置

    Config::$isProduction =  false;
    Config::$clientId =  env('MATERAI_CLIENT_ID');
    Config::$clientSecret =  env('MATERAI_SECRET');
    Config::$authCode =  env('MATERAI_CODE');

2.2 对文档进行盖章

要对文档进行盖章，您需要将 PDF 转换为 base64，可以使用 Base64 Guru 进行转换。添加 use Gandhist\Ematerai\Stamping;

    $stamp = new Stamping;
    $base64 = "your_base_64_pdf_file";
    $filename = "your_file_name.pdf";
    $callback = "https://webhook.site/e91fe71f-6672-4ae6-86b2-9018ba4df5a3?validation_key=ABCDE";
    $annotation = [[
        "page"  =>  4, // page you want to stamp
        "position_x"  =>  150, // set x axis
        "position_y"  =>  450, // set y axis
        "element_width"  =>  80,
        "element_height"  =>  80,
        "canvas_width"  =>  836,
        "canvas_height"  =>  1181,
        "type_of"  =>  "meterai"
    ]];
    $stamping = $stamp->stamp($base64, $filename, $annotation, $callback);

2.3 通过文档 ID 获取文档详情

添加 use Gandhist\Ematerai\Document;

$doc = new Document;
return $doc->detail("<document-id>");

2.4 通过文档 ID 重新发送/重新盖章文档

添加 use Gandhist\Ematerai\Stamping;

$doc = new Stamping;
return $doc->restamp("<document-id>");