Resolución de problemas
Guía completa de resolución de problemas para la integración de la API REST.
Resolución de problemas
| Emitir | Posible causa | Resolución |
|---|---|---|
| Opción de la API REST desactivada en la interfaz de usuario | Función no habilitada | Configurar yfs.sdf.restapi.enabled=Y y reiniciar OMS |
| Los encabezados no se propagan | No está incluido en la lista blanca | Añadir encabezados a yfs.rest.allowed.headers la propiedad |
| 401 Errores de acceso no autorizado | Credenciales no válidas | Comprueba el token JWT, la configuración de « OAuth » o la importación del certificado |
| Errores 404: Página no encontrada | URL incorrecto | Comprueba que la URL de la API externa URL sea correcta |
| Variables que no se resuelven | Error de sintaxis | Comprueba la sintaxis: ${prop}, /xpath, $.json, #{h:header}, #{q:param} |
| El JSON no funciona | Falta configuración | Añadir un servicio a yfs.xmljson.wrapjson.forflows la propiedad |
| Tiempo de espera de conexión | Problema de red o cortafuegos | Comprueba la conectividad de red y aumenta el valor del tiempo de espera |
| Errores de certificado con autenticación «None» | El certificado no se ha importado | Importar un certificado de API externo al almacén de claves de OMS |
| OAuth El actualizador de tokens falla | Configuración de « OAuth » no válida | Comprueba el ID de cliente, el secreto y el token URL |
Preguntas frecuentes
¿Puedo utilizar la autenticación JWT?
Sí, pero JWT no aparece en el menú desplegable de la interfaz de usuario. Configúralo utilizando encabezados personalizados con el Authorization encabezado.
¿Cómo puedo añadir encabezados personalizados a la lista blanca?
Establece la yfs.rest.allowed.headers propiedad con los nombres de las cabeceras separados por comas. El valor predeterminado es Authorization,Content-Type,Accept,X-*.
¿Puedo sobrescribir los encabezados entrantes?
Sí, especificando un valor diferente en la definición del servicio. El valor configurado tiene prioridad.
¿Qué pasa si mi API requiere autenticación básica?
Configúralo utilizando encabezados personalizados con Authorization: Basic
<base64-encoded-credentials>.
¿Cómo puedo comprobar si la función está activada?
Ve a y comprueba que el botón de opción «API REST» esté activado y no aparezca desactivado.
¿Puedo utilizar tanto XPath como JSONPath en el mismo servicio?
Sí, pero XPath solo funciona con datos XML y JSONPath solo funciona con datos JSON.
¿Cómo puedo solucionar los problemas relacionados con la resolución variable?
Activa el registro de depuración con yfs.yfs.10=verbose y revisa los registros para obtener detalles sobre la resolución de variables.
Obtener ayuda
- Consulte los registros para ver los mensajes de error detallados
- Póngase en contacto con el servicio de asistencia de IBM y facilite los archivos de registro y los detalles de configuración
- Consulte la documentación para ver ejemplos de configuración
- Prueba las API externas de forma independiente para aislar los problemas