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ámetro Valor
URL /submit
Method POST
Content-Type multipart/form-data
title Descripción del trabajo para mostrar
format Id de diseño
data Datos (en CSV, JSON, XML or Excel)
callback opcional JSONP callback
oauth_token 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 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ámetro Valor
URL /authorize
Method GET
client_id Identificación del cliente (desde el registro de la aplicación)
response_type code
scope full
redir_uri Redirigir URI (debe coincidir con URI en el registro de la aplicación)
state Informació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ámetro Valor
URL /auth
Method POST
grant_type refresh_token
refresh_token Actualizar token (a partir de la autorización de la aplicación)
Devoluciones Estructura 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ámetro Valor
URL /auth
Method POST
grant_type authorization_code
code Código de autorización (de redirección)
client_id Identificación del cliente (desde el registro de la aplicación)
client_secret Secreto del cliente (desde el registro de la aplicación)
refresh_token Actualizar token (a partir de la autorización de la aplicación)
Devoluciones Estructura 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-2020 by RSJ Software GmbH Stockdorf. All rights reserved. - Version:1.12.0208