امضای الکترونیکی چیست؟
امضای الکترونیکی یا امضای الکترونیکی به داده‌هایی به شکل الکترونیکی اطلاق می‌شود که به طور منطقی با سایر داده‌ها به شکل الکترونیکی مرتبط است و توسط امضاکننده برای امضا استفاده می‌شود. این نوع امضا تا زمانی که به الزامات مقررات خاص پایبند باشد، همان جایگاه حقوقی امضای دست‌نویس را دارد. امضاهای الکترونیکی می توانند به صورت متن دیجیتال، تصویر، بارکد، کد QR و غیره باشند.
امضای الکترونیکی یک مفهوم حقوقی متمایز از امضای دیجیتال است، یک مکانیسم رمزنگاری که اغلب برای پیاده سازی امضای الکترونیکی استفاده می شود. در حالی که یک امضای الکترونیکی می تواند به سادگی یک نام وارد شده در یک سند الکترونیکی باشد، امضای دیجیتال به طور فزاینده ای در تجارت الکترونیک و در پرونده های نظارتی برای پیاده سازی امضای الکترونیکی به روشی رمزنگاری شده استفاده می شود.
GroupDocs.Signature Cloud API؟
GroupDocs.Signature Cloud یک REST API برای ایجاد، تأیید و جستجوی انواع مختلف اشیاء Signature در اسناد در ابر است. پنج نوع اصلی امضای پشتیبانی شده وجود دارد که می توانید با آنها کار کنید:
- امضای متن
- امضای بارکد
- امضای کد QR
- امضای دیجیتالی
- امضای تصویر
- امضای مهر
چگونه با استفاده از E-Signing API با سند بارکد کار کنیم؟
این API برای افزودن امضاهای الکترونیکی به اسناد، بر اساس پارامترهای ارسال شده به عنوان آرایه ای از گزینه های امضا در نظر گرفته شده است. سند ارائه شده را می توان با استفاده از URL های خروجی یا مسیرها دانلود کرد.
در اینجا مراحل کار با امضای سند آمده است:
- آپلود فایل در فضای ذخیره سازی
- یک امضا ایجاد کنید.
- تأیید یک امضا
- جستجوی یک امضا
- دانلود فایل HTML.
1. آپلود فایل در فضای ذخیره سازی
کد زیر نحوه آپلود فایل ها را در فضای ذخیره سازی نشان می دهد.
### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/storage/file/signaturedocs%2Fone-page.docx?storageName=MyStorage"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
اکنون فایل ما “one-page.docx” در پوشه “signaturedocs” در فضای ذخیره سازی موجود است.
2. ایجاد امضای بارکد
GroupDocs.Signature Cloud REST API از امضای سند با بارکد پشتیبانی می کند. روش هایی را برای ایجاد امضای بارکد در صفحات سند با گزینه های مختلف از نوع بارکد، مکان، تراز، فونت، حاشیه و ظاهر با استفاده از داده های Signature Option Objects در بدنه درخواست ارائه می دهد.
کد زیر نحوه ایجاد امضای بارکد را نشان می دهد.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/create"
-H "accept: application/json" -H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": { \"FilePath\": \"one-page.docx\", \"StorageName\": \"MyStorage\", \"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 },} ]}"
3. تأیید یک امضا
GroupDocs.Signature Cloud REST API روش هایی را برای تأیید امضای بارکد در صفحات اسناد با گزینه های مختلف برای شماره صفحه، متن و معیارهای جستجو با استفاده از داده های Verification Options Objects در بدنه درخواست ارائه می دهد.
کد زیر نحوه تأیید امضای بارکد را نشان می دهد.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/verify"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{\"FileInfo\": {\"FilePath\": \"signed/Signed_BarCode.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\",},\"VerifyOptions\": [{\"DocumentType\": \"Pdf\",
\"SignatureType\": \"Text\",\"Page\": 1,\"Text\": \"John\",\"MatchType\": \"Contains\"}] }}} ]}"
4. جستجوی یک امضا
GroupDocs.Signature Cloud API روشی برای جستجوی امضای بارکد در صفحات سند با گزینه های مختلف نوع بارکد، نام، متن، نوع مطابقت و سایر ویژگی های جستجو با استفاده از داده های Search Options Object در بدنه درخواست ارائه می دهد.
کد زیر نحوه جستجوی امضای بارکد را نشان می دهد.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/search"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": {\"FilePath\": \"signaturedocs/one-page.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\" }, \"SearchOptions\": [ {\"DocumentType\": \"Pdf\",\"SignatureType\": \"Barcode\",
\"Page\": 1,\"Text\": \"123\",\"BarcodeType\": \"Code128\",\"MatchType\": \"Contains\"}] }"
5. دریافت فایل
کد زیر نحوه دانلود یک فایل خاص را نشان می دهد.
### Download document from default storage
curl -X GET "https://api.groupdocs.cloud/v2.0/signature/storage/file/one-page.docx?storageName=MyStorage"
-H "accept: multipart/form-data"
-H "authorization: Bearer [Access Token]"
خودشه.
امروز یک آزمایش رایگان را شروع کنید
امروز یک دوره آزمایشی رایگان را شروع کنید – تنها چیزی که نیاز دارید این است که با سرویس GroupDocs Cloud ثبت نام کنید. پس از ثبت نام، آماده هستید تا ویژگی های پردازش فایل قدرتمند ارائه شده توسط GroupDocs Cloud را امتحان کنید.