皆さん、書類を印刷し、署名し、スキャンし、郵送していた昔の、書類に署名するという退屈な作業はもう必要ありません。このデジタル時代では、オンライン文書署名オプションにより作業が容易になりました。また、GroupDocs.Signature Cloud REST API は、サードパーティ ソフトウェアをインストールせずにアプリケーションに電子署名の機能を追加する、テスト済みの信頼できる電子署名 REST API です。テキスト、スタンプ、QR コード、バーコード、画像、デジタル署名を適用することで、文書を電子的に保護するのに役立ちます。 GroupDocs.Signature Cloud 19.5 の新バージョンがリリースされました。
このリリースで行われたすべての新機能/機能強化についてのアイデアを得るには、このバージョンの詳細な リリース ノート を確認してください。
新着情報
API バージョン - API バージョン V2 を導入しました
認証 - JWT(JSON Web Token)認証
署名 API - ドキュメントの追加情報を取得するのと同じように、署名を作成、検証、検索するための簡素化された API メソッド
ファイル API – ファイルをアップロード、ダウンロード、コピー、移動、削除するためのメソッドを導入しました。入力ドキュメントとレンダリング結果をクラウド ストレージに追加します。
フォルダー API - クラウド ストレージ内でフォルダーを作成、コピー、移動、削除するためのメソッドを導入しました。
ストレージ API - ストレージ情報とファイル情報を取得するためのメソッドが導入されました
使い方
このリリースの主な変更点は、V2 API バージョンの導入であり、すべて新しい API バージョンです。これは、メソッドとオプションが少なく、より単純化された API です。また、内部アーキテクチャがより最適化され、洗練されました。このバージョンの API には、クラウド ストレージを操作するためのメソッドが含まれています。そのため、別の API を使用する代わりに、GroupDocs.Signature Cloud REST API を使用してストレージ操作を実行できます。
ここでは、GroupDocs.Signature Cloud V2 API バージョンがどのように機能し、V1 と異なるのかを説明します。次の手順に従って、V1 と V2 を使用して Word 文書にバーコード署名を追加します。
- アクセストークンの取得
- ソースドキュメントをストレージにアップロードする
- ソース文書にバーコード署名を追加する
次の cURL の例から、V2 の例で JWT 認証を使用していることがわかります。 V1 API バージョンの OAuth 2.0 および URL 署名リクエスト認証方法は、V2 ではサポートされなくなっていることに注意してください。 V2 API バージョンでは、JWT(JSON Web Token) 認証をサポートしました。
新しいリリース メソッドでは、GroupDocs.Storage Cloud メソッドの代わりに、ファイルをストレージにアップロードするために V2 API の File メソッドを使用しました。次の例との最後の違いは、V2 では署名の詳細をパラメーターとして渡すことによって、サポートされているすべての署名タイプに対して単一の API 作成が使用されることです。ただし、V1 では、署名タイプごとに異なる API を呼び出していました。
V1.1 の例
### Retrieve access token
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl "https://api.groupdocs.cloud/oauth2/token"
-X POST
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
-H "Content-Type: application/x-www-form-urlencoded"
-H "Accept: application/json"
### Upload file to Aspose Cloud Storage
curl "https://api.aspose.cloud/v1.1/storage/file?path=one-page.docx"
-X PUT
-T C:/Temp/one-page.docx
-H "Content-Type: multipart/form-data"
-H "Accept: application/json"
-H "Authorization: Bearer [ACCESS_TOKEN]"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v1/signature/one-page.docx/barcode"
-X POST
-H "accept: application/json"
-H "Content-Type: application/json"
-H "authorization: Bearer [ACCESS_TOKEN]"
-d "{"BarcodeTypeName": "Code128","BorderVisiblity" : true,"BorderDashStyle" : "DashDotDot","BorderWeight" : 1,"Opacity" : 0.5,"Margin": {"All": 0,"Left": 0,"Top": 0,"Right": 0,"Bottom": 0},"SheetNumber": 1,"RowNumber": 11,"ColumnNumber": 22,"BorderVisiblity": true,"BorderDashStyle": 5,"BorderTransparency": 0.0,"BorderWeight": 1.0,"BackgroundTransparency": 0.1,"SignatureImplementation": "TextStamp","Text": "John Smith","Width": 100,"Height": 100,"LocationMeasureType": "Pixels","SizeMeasureType": "Pixels","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Center","MarginMeasureType": "Pixels","SignAllPages": false,"Font": {"FontFamily": "Times New Roman","FontSize": 14.0,"Bold": false,"Italic": false,"Underline": false},"ForeColor": {"Web": "Black"},"BorderColor": {"Web": "Black"},"BackgroundColor": {"Web": "OrangeRed"},"OptionsType": "WordsSignBarcodeOptionsData"}"
V2.0の例
### Retrieve access token JWT(JSON Web Token)
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl -v "https://api.groupdocs.cloud/connect/token"
-X POST
-H "Content-Type: application/x-www-form-urlencoded"
-D "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
### Upload file into the storage
curl --request POST "https://api.groupdocs.cloud/v2/signature/storage/file/one-page.docx"
--header "authorization: Bearer [ACCESS_TOKEN]"
--data-binary @"c:\temp\one-page.docx"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v2.0/signature/create"
-X POST
-H "accept: application/json"
-H "authorization: Bearer [ACCESS_TOKEN(JWT)]"
-H "Content-Type: application/json"
-d "{"FileInfo": { "FilePath": "one-page.docx", "StorageName": "", "VersionId": "", "Password": "" }, "SaveOptions": { "OverwriteExisting": true, "OutputFilePath": "result-one-page.docx", "SaveFormat": "docx" }, "SignOptions": [ { "DocumentType": "WordProcessing", "SignatureType": "Barcode", "Page": 1, "AllPages": false, "PagesSetup": { "FirstPage": false, "LastPage": true, "OddPages": false, "EvenPages": true, "PageNumbers": [1] }, "Text": "John Smith", "BarcodeType": "Code128", "Left": 2, "Top": 2, "Width": 200, "Height": 100, "Stretch": "None", "RotationAngle": 45, "HorizontalAlignment": "Left", "VerticalAlignment": "Center", "LocationMeasureType": "Pixels", "SizeMeasureType": "Pixels", "Margin": { "All": 5, "Left": 5, "Top": 5, "Right": 5, "Bottom": 5 }, "MarginMeasureType": "Pixels", "Font": { "FontFamily": "Times New Roman", "FontSize": 14.0, "Bold": false, "Italic": false, "Underline": false }, "ForeColor": { "Web": "DarkOrange" }, "BorderColor": { "Web": "DarkOrange", "Alpha": "20", }, "BackgroundBrush": { "Color": {"Web": "DarkBlue"}, "BrushType": "SolidBrush" }, "BorderVisiblity": true, "BorderDashStyle": "Dash", "BorderTransparency": 0.55, "BorderWeight": 12.0, "BackgroundTransparency": 0.8, "TextHorizontalAlignment": "Left", "TextVerticalAlignment": "Top", "Opacity": 0.5, "CodeTextAlignment": "Below", "InnerMargins": { "All": 5, "Left": 5, "Top": 5, "Right": 5, "Bottom": 5 },} ]}"
フィードバックを提供します
GroupDocs.Signature Cloud 19.5 の新しいバージョンについてのご意見を下記にコメントしてお気軽にお寄せください。または、サポート フォーラム にアクセスして、ご提案がある場合、または API に期待される特定の機能や改善が必要な場合はお知らせください。
まだ REST API を試す機会がない場合は、今すぐ無料トライアルを開始してください。必要なのは、groupdocs.cloud にサインアップすることだけです。サインアップすると、groupdocs.cloud が提供する強力なファイル処理機能を試すことができます。