Objetivo: Los siguientes servicios web se crearon para lograr un método con el objetivo de enlazar otro sistema con la plataforma. No importa que método de integración se deseé, el sistema está planeado para funcionar siempre y cuando obtenga las variables esperadas en cada uno de los servicios. Para esto de desarrollaron 10 web services independientes que deberán de ser invocados conforme se deseé.
Parámetros necesarios:
idcat: Número del tipo de proceso a dar de alta
tipo: id del tipo de contacto.
perfil: id del tipo a dar de alta los usuarios firmantes.
org: Número de la organización.
org: Nombre de la organización. Este valor sólo es necesario para setear sesión.
t003c002: Usuario iniciador del servicio.
t003c004: Password del usuario iniciador del servicio.
idsol: id único del contacto t003c002.
key1: Token de acceso 1.
key2: Token de acceso 2.
app: Id de la aplicación a asignar el proceso.
2. Importante sobre las sesiones
Tiempo de sesión: La sesión es válida por 5 minutos. Después de este tiempo, se eliminará automáticamente.
Múltiples sesiones: Puedes tener varias sesiones abiertas al mismo tiempo, pero cada una tiene un límite de 5 minutos.
Vinculación con la IP: La sesión se vincula a la IP desde la cual se realiza el llamado. Si necesitas una IP fija, solicita este requerimiento a la mesa de control.
3. Consideraciones de seguridad
Seguridad del token: Asegúrate de que tu token de acceso esté protegido y solo se use en entornos seguros.
Sesión asociada a IP: Si usas una IP variable, asegúrate de que las solicitudes se hagan desde la misma IP durante la sesión.
Resumen
Obtén tu token de acceso y datos de usuario.
Realiza una solicitud POST al endpoint especificado para iniciar sesión.
Incluye el token y los parámetros necesarios en el header y el cuerpo de la solicitud.
La sesión tiene una duración de 5 minutos.
La sesión se vincula a tu IP, y si es variable, cada solicitud debe hacerse desde la misma IP.
¿Necesitas ayuda?
Si tienes dudas, contacta a soporte para un asesoramiento personalizado.
1) Logeo de usuario para alta de servicios
Para poder dar de alta cualquier servicio, deberá de setearse una sesión (sesión del usuario iniciador del servicio). Es recomendable que cada llamado se realice con dicha sesión ya que tiene una vigencia de 5 minutos. Se pueden tener múltiples sesiones abiertas en el servicio. El tiempo de la sesión abierta será de 5 minutos; pasado el plazo mencionado se desechará la sesión (no es necesario hacer nada adicional).
La sesión irá ligada a la IP del servidor donde se hace el llamado, dicha IP puede ser fija o variable. Para mayor seguridad si requieren una IP fija favor de solicitar a la mesa de control. Enviar solicitud de Logeo - Realiza una solicitud HTTP POST al siguiente endpoint
https://portal.seguridata.com/resolve/rest/log/in
Para comenzar, el usuario debe abrir Postman, seleccionar el método POST en el campo de solicitud, e ingresar la URL de inicio de sesión para habilitar el proceso de autenticación.
Ejemplo Postman:
Realiza una solicitud HTTP POST al siguiente endpoint
Headers
Una vez que la URL esté configurada, es necesario agregar el parámetro org y las variables token1 del valor t003c002 y token2 de t003c004.
El cliente debe ingresar en la sección Headers• la siguiente clave y valor BASICclientbasic: y los token1*token2 separados con un asterisco en el medio:
Key
Value
Descripción
✓AUTHORIZATION
BASICclientbasic:vdsisdfixs*ssxtr131514tlsiosd
BASICclientbasic:token1*token2
Ejemplo Postman:
Headers
Body
En la sección Body•, asegúrese de seleccionar la opción x-www-form-urlencoded en la cual debe ingresar la org y las claves mencionadas anteriormente:
none
form-data
x-www-form-urlencoded
raw
binary
GraphQL
Key
Value
✓org
sandbox
✓t003c002
vdsisdfixs
✓t003c004
ssxtr131514tlsiosd
Ejemplo Postman:
Después, simplemente haga clic en el botón Enviar (Send) para enviar la solicitud. Este procedimiento se repetirá en cada paso: seleccionar POST, ingresar la URL correspondiente, agregar los parámetros necesarios, y presionar Enviar para avanzar a la siguiente pantalla o acción.
Respuesta:
✅ Respuesta exitosa: Responderá el idprc (número único en texto plano del proceso generado). ❌ Respuesta no exitosa: 0 o null
Ejemplo Postman:
2) Crear un nuevo proceso
Se recibirá una instrucción para que se den de alta un nuevo proceso de una organización y categoría de proceso indicada. Para dar de alta deberás:
Realiza una solicitud HTTP POST al siguiente endpoint
En la sección Body•, siguiendo en el body x-www-form-urlencoded agregue las siguientes claves y valores:
none
form-data
x-www-form-urlencoded
raw
binary
GraphQL
Key
Value
Descripción
✓idcat
15
Valor variable proporcionada idcat (categoríad el proceso a dar de alta)
✓idsol
122
Valor variable proporcionada idsol (número del usuario a dar de alta el proceso)
Ejemplo Postman:
Respuesta:
✅ Respuesta exitosa: Responderá el idprc (número único en texto plano del proceso generado). ❌ Respuesta no exitosa: 0 o null
Ejemplo Postman:
2b) Crear un nuevo proceso | en especifico
Se recibirá una instrucción para que se den de alta un nuevo proceso de una organización, categoría y aplicación en específico del proceso. Para dar de alta deberás:
Realiza una solicitud HTTP POST al siguiente endpoint
En la sección Body•, seleccionamos nuevamente x-www-form-urlencoded y agregamos las siguientes claves y valores. (Solo en el paso anterior cambiamos a form-data para la carga del documento en formato file; en todos los demás pasos, utilizamos x-www-form-urlencoded).
none
form-data
x-www-form-urlencoded
raw
binary
GraphQL
Key
Value
Descripción
✓idprc
244
Valor idprc del proceso a actualizar
✓fld
p8
Campo a actualizar
✓data
Nombreprueba
Valor de data (información de entrada)
✓tipo
0
Tipo de campo (0 alfanumérico, 1 numérico)
Ejemplo Postman:
Respuesta:
✅ Respuesta exitosa: Responderá el idprc (número único en texto plano del proceso generado). ❌ Respuesta no exitosa: 0 o null
Ejemplo Postman:
5) Agregar número de firmantes
Realiza una solicitud HTTP POST al siguiente endpoint
En la sección Body•, utilizando el formato x-www-form-urlencoded, agregue las siguientes claves y valores:
none
form-data
x-www-form-urlencoded
raw
binary
GraphQL
Key
Value
Descripción
✓idprc
244
Valor idprc del proceso a obtener archivo ZIP con los documentos relacionados al proceso de firma
Ejemplo Postman:
Respuesta:
✅ Respuesta exitosa: Responderá con un archivo ZIP que contiene los documentos relacionados con el proceso de firma. ❌ Respuesta no exitosa: 0 o null
Ejemplo Postman:
Soporte técnico
Para cualquier consulta, problema técnico o asistencia, por favor póngase en contacto con nuestro equipo de soporte técnico al correo electrónico soporte@seguridata.com
Búsqueda de palabras clave
Guía para usar Servicios Web de SeguriData en Postman. Consulta los códigos a continuación:
Si necesita más información o asistencia adicional, no dude en ponerse en contacto con nosotros.
¡Gracias por confiar en nosotros!
