¿Qué es una Firma Electrónica?
Una firma electrónica o firma electrónica se refiere a datos en formato electrónico que están lógicamente asociados con otros datos en formato electrónico y que el firmante utiliza para firmar. Este tipo de firma otorga el mismo valor legal que una firma manuscrita siempre que se ajuste a los requisitos de la normativa específica. Las firmas electrónicas pueden ser en forma de texto digital, imágenes, código de barras, códigos QR, etc.
Las firmas electrónicas son un concepto legal distinto de las firmas digitales, un mecanismo criptográfico que se usa a menudo para implementar firmas electrónicas. Si bien una firma electrónica puede ser tan simple como un nombre ingresado en un documento electrónico, las firmas digitales se usan cada vez más en el comercio electrónico y en las presentaciones reglamentarias para implementar firmas electrónicas protegidas criptográficamente.
GroupDocs.API en la nube de firmas?
GroupDocs.Signature Cloud es una API REST para crear, verificar y buscar diferentes tipos de objetos de firma para documentos en la nube. Hay cinco tipos principales de firma compatibles con las que puede operar:
- Firma de texto
- Firma de código de barras
- Firma de código QR
- Firma digital
- Firma de imagen
- Sello Firma
¿Cómo trabajar con un documento de código de barras utilizando la API de firma electrónica?
Esta API está destinada a agregar firmas electrónicas a los documentos, en función de los parámetros pasados como una matriz de opciones de firma. El documento renderizado se puede descargar usando las URL o rutas de salida.
Estos son los pasos para trabajar con la firma de documentos:
- Subir archivo a un almacenamiento.
- Crear una firma.
- Verificar una firma.
- Buscar una firma.
- Descargar archivo HTML.
1. Subir archivo a un almacenamiento
El siguiente código demuestra cómo cargar archivos en un almacenamiento.
### 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]"
Ahora nuestro archivo “one-page.docx” está disponible en la carpeta “signaturedocs” en el almacenamiento.
2. Creación de una firma de código de barras
GroupDocs.Signature Cloud REST API admite la firma de un documento con código de barras. Proporciona métodos para crear una firma de código de barras en las páginas del documento con diferentes opciones de tipo de código de barras, ubicación, alineación, fuente, márgenes y apariencia mediante el uso de datos Objetos de opción de firma en el cuerpo de la solicitud.
El siguiente código demuestra cómo crear una firma de código de barras.
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. Verificar una firma
GroupDocs.Signature Cloud REST API proporciona métodos para verificar la firma del código de barras en las páginas de documentos con diferentes opciones para el número de página, el texto y los criterios de búsqueda mediante el uso de datos Objetos de opciones de verificación en el cuerpo de la solicitud.
El siguiente código demuestra cómo verificar la firma del código de barras.
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. Buscar una firma
GroupDocs.Signature Cloud API proporciona un método para buscar la firma del código de barras en las páginas del documento con diferentes opciones de tipo de código de barras, nombre, texto, tipo de coincidencia y otras funciones de búsqueda mediante el uso de datos Objeto de opciones de búsqueda en el cuerpo de la solicitud.
El siguiente código demuestra cómo buscar la firma del código de barras.
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. Descargar archivo
El siguiente código demuestra cómo descargar un archivo específico.
### 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]"
Eso es todo.
Comience una prueba gratuita hoy
Comience una prueba gratuita hoy; todo lo que necesita es registrarse en el servicio en la nube de GroupDocs. Una vez que se haya registrado, estará listo para probar las potentes funciones de procesamiento de archivos que ofrece GroupDocs Cloud.