FULL REST API v40
El siguiente documento tiene como objetivo dar detalles de las configuraciones y parámetros básicos para poder integrar la funcionalidad de la firma digital en tus aplicaciones de negocio mediante API REST
¿Por donde comenzar?
Paso 1: registrate y accede a tu API KEY
Lo primero, tienes que registrarte en nuestra aplicación web. Contamos con un entorno de producción, que ofrece los servicios de firma digital para tus documentos, y un entorno de pruebas (“sandbox”) que podrás utilizar para la fase de integración.
Sólo por registrarte, tendrás acceso a un paquete de 10 firmas para comenzar a funcionar!
Entorno de Producción
Aquí deberán estar los documentos reales
- Aplicación web: https://app.firmar.info
- endpoint API REST: https://app.firmar.online
Entorno de pruebas “Sandbox”
Puedes utilizarlo para pruebas de integración
- Aplicación web: https://app.firmar.info
- endpoint API REST : https://restapi.firmar.online
Dentro de la aplicación, tienes que generar tu API-Key (desde ajustes de la WebApp)
Solicita tu paquete de firmas a tu contacto comercia
Paso 2: Integración
Aquí tienes algunos recursos que te ayudarán a integrar la firma digital en tus procesos de negocio:
Definiciones Swagger
Accede a las definiciones de los métodos en Swagger.
Aquí encontraras todos los métodos y esquemas de firmar.online:
- Enviar a firmar: envía documentos a otras Personas para que el firmen sobre su propio dispositivo (Firma Remota)
- Firma Presencial en tus dispostivos
- Validar la firma digital de documentos
- Firmar Documentos en servidor
Colección de POSTMAN
Descárgate la colección API REST para utilizarla en tus peticiones.
La colección pública contiene ejemplos de peticiones que comparten la misma estructura y parámetros de configuración.
La colección invoca distintas VARIABLES: Si estás utilizando POSTMAN, estas variables están pre-configuradas para usar como referencia, pero puedes cambiarlas segun te convenga.
Lo PRIMERO. Modificar la variable API-KEY que has generado en la WebApp en el paso anterior.
Tendrás 2 API – Key, una para Producción y otra para SandBox.
El endpoint contiene la variable: {{base_url}}/…/…
Dependiendo del ambiente en el que quieras firmar, debes modificar la variable {{base_url}}. Recuerda:
- Sandbox: https://restapi.firmar.info
- Producción: https://restapi.firmar.online
Paso 3 Pase a Producción
Si has realizado la integración en el entorno de pruebas, sólo tienes que cambiar el endpoint de producción.
Recuerda que también tienes que tomar el API KEY de la aplicación web de producción!!