Full REST API v40

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 webhttps://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!!