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 impression

ParámetroValor
URL/submit
MethodPOST
Content-Typemultipart/form-data
titleDescripción del trabajo para mostrar
formatId de diseño
dataDatos (en CSV, JSON, XML or Excel)
callbackopcional JSONP callback
oauth_tokentoken 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 independientes 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:

  • Identificador 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 nombre.

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/authorize
MethodGET
client_idIdentificación del cliente (desde el registro de la aplicación)
response_typecode
scopefull
redir_uriRedirigir URI (debe coincidir con URI en el registro de la aplicación)
stateInformació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.
  • Identificador 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
MethodPOST
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
MethodPOST
grant_typeauthorization_code
codeCódigo de autorización (de redirección)
client_idIdentificación del cliente (desde el registro de la aplicación)
client_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.0162