Chlapi, staré nudné podepisování dokumentů je pryč, když jste dokumenty tiskli, podepisovali, skenovali a publikovali. Nyní v této digitální éře možnosti online podepisování dokumentů usnadnily život. A GroupDocs.Signature Cloud REST API je testované a spolehlivé e-Signature REST API, které přidává výkon elektronických podpisů do vašich aplikací bez instalace jakéhokoli softwaru třetích stran. Pomáhá vám elektronicky zabezpečit vaše dokumenty použitím textu, razítka, QR-kódu, čárového kódu, obrázku a digitálních podpisů. Vyšla nová verze GroupDocs.Signature Cloud 19.5.
Podívejte se prosím na podrobné poznámky k vydání této verze, abyste získali představu o všech nových funkcích/vylepšeních provedených v této verzi.
Co je nového
Verze API – Představena verze API V2
Autentizace - JWT (JSON Web Token) ověřování
Signature API – Zjednodušené metody API pro vytváření, ověřování a vyhledávání podpisů, stejně jako získávání dalších informací o dokumentech
File API – Zavedené metody pro nahrávání, stahování, kopírování, přesouvání, mazání souborů: vkládání dokumentů a výsledků vykreslování v cloudovém úložišti
Folder API – Zavedené metody pro vytváření, kopírování, přesouvání a odstraňování složek v cloudovém úložišti
Storage API – Zavedené metody pro získávání informací o úložišti a souborech
Jak to funguje
Hlavní změnou v této verzi je zavedení verze V2 API, je to celá nová verze API. Je to více zjednodušené API s méně metodami a možnostmi. Má také optimalizovanější a propracovanější vnitřní architekturu. V této verzi API obsahuje metody pro práci s cloudovým úložištěm. Takže můžete provádět operace úložiště pomocí GroupDocs.Signature Cloud REST API místo použití samostatného API.
Zde vám ukážeme, jak funguje GroupDocs.Signature Cloud V2 API verze a je jiná než V1. Přidáme podpis čárového kódu do dokumentu aplikace Word pomocí V1 a V2 podle následujících kroků:
- Získat přístupový token
- Nahrajte zdrojový dokument do úložiště
- Přidejte podpis čárového kódu do zdrojového dokumentu
Z následujících příkladů cURL si můžete všimnout, že jsme v příkladu V2 použili ověřování JWT. Upozorňujeme, že OAuth 2.0 a autentizační metody žádosti o podepisování URL verze V1 API již nejsou ve V2 podporovány. Verze V2 API nyní podporuje ověřování JWT (JSON Web Token).
V nové metodě vydání jsme místo metody GroupDocs.Storage Cloud použili metodu File V2 API pro nahrávání souboru do úložiště. A poslední rozdíl oproti následujícím příkladům, ale v neposlední řadě, ve V2 se pro všechny podporované typy podpisů používá jediné vytvoření API předáním podrobností podpisu jako parametru. Ve V1 jsme však používali pro každý typ podpisu volat různá rozhraní API.
Příklad 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"}"
Příklad 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 },} ]}"
Poskytnout zpětnou vazbu
Neváhejte a napište nám komentář níže a podělte se o své názory na novou verzi GroupDocs.Signature Cloud 19.5. Nebo navštivte naše Fórum podpory a dejte nám vědět, pokud máte nějaké návrhy nebo pokud potřebujete nějaké konkrétní funkce/vylepšení, které očekáváte od našeho API.
A pokud jste ještě neměli možnost vyzkoušet naše REST API, jednoduše spusťte bezplatnou zkušební verzi ještě dnes. Vše, co potřebujete, je zaregistrovat se na groupdocs.cloud. Jakmile se zaregistrujete, jste připraveni vyzkoušet výkonné funkce zpracování souborů, které nabízí groupdocs.cloud.