RSJ-Labelprinter - follow the QR-Code RSJ-Next Generation Label Printing System - makes workflow easier RSJ-Software, Company Logo

Integración de aplicaciones externas

Servicios web

RSJ LPSNG proporciona los siguientes servicios web:

  • Enviar trabajo de impresión

Enviar trabajo de impresión

ParámetroValor
URL/ enviar
MétodoPOST
Tipo de contenidomultipart / form-data
títuloDescripción del trabajo para mostrar
formatoID de diseño
datosDatos (en CSV, JSON, XML o Excel)
devolución de llamadaDevolución de llamada JSONP opcional
oauth_tokenEl token de acceso OAuth2 (si no se especifica en el encabezado HTTP de autorización en el esquema OAuth)

autenticación

RSJ LPSNG utiliza el protocolo estándar OAuth2 para integrar de forma segura múltiples aplicaciones externas independidas para una multitud de usuarios.

RSJ LPSNG utiliza esta autenticación como base para sus decisiones de enrutamiento

Registro de aplicación externa

Los desarrolladores pueden registrar una aplicación externa con RSJ LPS NG en línea al proporcionar:

  • Nombre de la aplicación
  • Descripción de la aplicación
  • Icono de aplicación
  • URL de redireccionamiento de la aplicación

Recibirán:

  • ID de aplicación
  • Secreto de la aplicación

Autorización de aplicación externa

Los usuarios finales pueden autorizar en línea las aplicaciones externas para usar RSJ LPS NG en su comportamiento.

Vista de usuario final

  1. El usuario hace clic en un enlace en la aplicación externa, que los redirige al inicio de sesión RSJ LPSNG (si aún no lo ha hecho) y luego a la pantalla de autorización RSJ LPS NG
  2. Si el usuario acepta el enlace de la aplicación, se redirige de nuevo a la aplicación externa donde se almacena la información de autenticación.

Vista de aplicación externa

La aplicación externa proporciona la siguiente información con la redirección:

  • Identificación de la aplicación (asignada durante el registro de la solicitud)
  • URL de devolución de llamada (especificada durante el registro de la aplicación)
  • Información de contexto opcional (para devolución de llamada)
ParámetroValor
URL/ autorizar
MétodoGET
client_idIdentificación del cliente (desde el registro de la aplicación)
tipo de respuestacódigo
alcancelleno
redir_uriRedirigir URI (debe coincidir con URI en el registro de la aplicación)
estadoInformación de contexto opcional para devolución de llamada

Después de la autorización exitosa, la sesión del usuario final se redirige a la aplicación externa con los siguientes parámetros:

  • Información de contexto (de redirección)
  • Código de autorización temporal (válido por 10 minutos)

La aplicación externa llama a un servicio web para intercambiar la autorización temporal con el token de actualización permanente al proporcionar:

  • Código de autorización temporal.
  • ID de aplicación
  • Secreto de la aplicación
  • URL de devolución de llamada

La aplicación externa almacena permanentemente el token de actualización para el usuario final

ParámetroValor
URL/ auth
MétodoPOST
grant_typerefresh_token
refresh_tokenActualizar token (a partir de la autorización de la aplicación)
DevolucionesEstructura JSON

Solicitudes de Solicitud Externas

La aplicación externa debe intercambiar el token de actualización por un token de acceso válido temporalmente (60 minutos) antes de acceder a RSJ LPSNG para un usuario final. Llama a un servicio web con:

  • Actualizar token

Recibe:

  • Token de acceso temporal (60 minutos)

La aplicación externa incluye este token de acceso en sus solicitudes de servicio web (en el encabezado HTTP de Auth o como un parámetro)

RSJ LPSNG asocia el token de acceso con la aplicación externa y el usuario final.

El token de acceso puede dejar de ser válido en cualquier momento (incluso antes de que caduque). En este caso, se devuelve un error 401 y la aplicación externa debe recuperar un nuevo token de acceso antes de volver a intentar la solicitud fallida.

ParámetroValor
URL/ auth
MétodoPOST
grant_typecódigo_autorización
códigoCódigo de autorización (de redirección)
client_idIdentificación del cliente (desde el registro de la aplicación)
cliente_secretSecreto del cliente (desde el registro de la aplicación)
refresh_tokenActualizar token (a partir de la autorización de la aplicación)
DevolucionesEstructura JSON

Casos de uso

Contacto

Contáctenos para más información:

Name
Company
Email
Phone
How can we help you?

Or contact us directly:

RSJ Software GmbH
Grubmuehl 20
82131 Stockdorf
Germany

Phone: +49 89 89 41 42-0
Fax: +49 89 89 41 42-80
E-Mail: info@rsj.de

© Copyright 2011-2019 by RSJ Software GmbH Stockdorf. All rights reserved. - Version:1.12.0070