本日、GroupDocs は次世代 GroupDocs.Signature Cloud 17.12 の初公開リリースを発表します。これは、追加のソフトウェアをインストールせずにアプリケーションに電子署名の機能を追加するための電子署名 REST API です。 GroupDocs.Signature Cloud API は、電子署名の追加、署名の検証、検索などの機能を備えた電子署名機能をアプリに提供する簡単な方法です。 サポートされているファイル形式 の署名と他の機能。 GroupDocs.Signature Cloud の最初のバージョンで提供される機能の完全なリストについては、リリース ノート を確認してください。次のセクションでは、これらの機能に関する詳細について説明します。

サポートされている署名の種類

GroupDocs.Signature Cloud の最初のバージョンは、API で次のタイプの署名をサポートします。

  • デジタル署名
  • バーコード署名
  • QRコード署名
  • テキスト署名
  • 画像の署名

ドキュメントにデジタル署名を追加する

GroupDocs.Signature クラウド REST API は、ドキュメントへのデジタル署名の追加をサポートします。リクエスト本文の署名オプション オブジェクト データを使用して、証明書の種類、場所、配置、フォント、余白、外観のさまざまなオプションを使用してドキュメント ページにデジタル署名を作成するメソッドを提供します。その目的については、次の URI、REST コマンド(Curl)、および .NET SDK の例を参照してください。 URI

https://api.groupdocs.cloud/v1/signature/{filename}/digital

データのリクエスト

{"Visible": true,"Password": "password","CertificateGuid": "temp.pfx","ImageGuid": "signature.jpg","Left": 10,"Top": 10,"Width": 40,"Height": 10,"LocationMeasureType": "Millimeters","SizeMeasureType": "Millimeters","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Bottom","Margin": {"All": 10,"Left": 10,"Top": 10,"Right": 10,"Bottom": 10},"MarginMeasureType": "Millimeters","Opacity": 0.5,"SignAllPages": true,"DocumentPageNumber": 1,"OptionsType": "PdfSignDigitalOptionsData"}

残りの例(cURL)

curl -v "https://api.groupdocs.cloud/v1/signature/01_pages.pdf/digital" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "{"Visible": true,"Password": "password","CertificateGuid": "temp.pfx","ImageGuid": "signature.jpg","Left": 10,"Top": 10,"Width": 40,"Height": 10,"LocationMeasureType": "Millimeters","SizeMeasureType": "Millimeters","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Bottom","Margin": {"All": 10,"Left": 10,"Top": 10,"Right": 10,"Bottom": 10},"MarginMeasureType": "Millimeters","Opacity": 0.5,"SignAllPages": true,"DocumentPageNumber": 1,"OptionsType": "PdfSignDigitalOptionsData"}" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”

.NET SDKの例

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};

var apiInstance = new SignatureApi(configuration);

try
{
    var signOptionsData = new GroupDocs.Signature.Cloud.Sdk.Model.PdfSignDigitalOptionsData()
    {
        DocumentPageNumber = 1,
        Height = 80,
        HorizontalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.HorizontalAlignmentEnum.Right,
        Left = 10,
        LocationMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.LocationMeasureTypeEnum.Pixels,
        Margin = new GroupDocs.Signature.Cloud.Sdk.Model.PaddingData() { Left = 10, Right = 10, Bottom = 10, Top = 10 },
        MarginMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.MarginMeasureTypeEnum.Pixels,
        Opacity = 0.5,
        SignAllPages = false,
        CertificateGuid = "temp.pfx",
        Password="password",
        ImageGuid="signature.jpg",
        Top = 100,
        VerticalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.VerticalAlignmentEnum.Center,
        Width = 100
    };
    var request = new PostDigitalRequest
    {
        Name = "02_pages.pdf",
        SignOptionsData = signOptionsData,
        Password = null,
        Folder = null,

    };

    var response = apiInstance.PostDigital(request);

    Debug.Print("FleName: " + response.FileName);

}
catch (Exception e)
{
    Debug.Print("Exception when signing document with digital signature: " + e.Message);
}

デジタル署名の検証

GroupDocs.Signature クラウド REST API は、署名されたドキュメントの検証をサポートします。リクエスト本文の検証オプション オブジェクト データを使用して、ページ番号、テキスト、検索条件のさまざまなオプションを使用してドキュメント ページのデジタル署名を検証するメソッドを提供します。その目的については、以下の URI、JSON リクエスト データ、REST コマンド(Curl)、および .NET SDK の例を参照してください。 URI

https://api-qa.groupdocs.cloud/v1/signature/{filename}/digital/verification?Folder={folder}

データのリクエスト

"{"DocumentPageNumber":1,"Password": "password","CertificateGuid": "temp.pfx","Comments": "verified data","SignDateTimeFrom": "1/12/2017","SignDateTimeTo":"12/12/2017","OptionsType":"PdfVerifyDigitalOptionsData"}

残りの例(cURL)

curl -v "[https://api-qa.groupdocs.cloud/v1/signature/Signed_Digital.pdf/digital/verification?Folder=signed"][7] \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "{"DocumentPageNumber":1,"Password": "password","CertificateGuid": "temp.pfx","Comments": "verified data","SignDateTimeFrom": "1/12/2017","SignDateTimeTo":"12/12/2017","OptionsType":"PdfVerifyDigitalOptionsData"}" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”

.NET SDKの例

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};
var apiInstance = new SignatureApi(configuration);
try
{
    var verifyOptionsData = new GroupDocs.Signature.Cloud.Sdk.Model.PdfVerifyDigitalOptionsData()
    {
        DocumentPageNumber= 1,
        Password = "password",
        CertificateGuid = "temp.pfx",
    };
    var request = new PostVerificationDigitalRequest
    {
        Name = "Signed_Digital.pdf",
        VerifyOptionsData = verifyOptionsData,
        Password = null,
        Folder = "signed"
    };
var response = apiInstance.PostVerificationDigital(request);
Debug.Print("FleName: " + response.FileName);
Debug.Print("Result: " + response.Result);
}
catch (Exception e)
{
Debug.Print("Exception when verifying Digital signature: " + e.Message);
}

APIエクスプローラー

GroupDocs for Cloud REST API には、Web ベースの API Explorer が付属しており、お気に入りのブラウザで API をすぐに試す最も簡単な方法を提供します。これは、クラウド API 用の GroupDocs の Swagger ドキュメントのコレクションです。したがって、単純に、まず GroupDocs for Cloud に サインアップし、APP キーと SID を取得して、Web ブラウザで対話的に GropuDocs.Signature Cloud Rest API のテストを開始する必要があります。

GroupDocs.Signature クラウド リソース

以下は、タスクを達成するために必要となるいくつかの役立つリソースへのリンクです。

今すぐ無料トライアルを開始してください

今すぐ無料トライアルを開始してください – 必要なのは、GroupDocs クラウド サービスにサインアップするだけです。サインアップすると、GroupDocs Cloud が提供する強力なファイル処理機能を試すことができます。