¿Qué son las API REST?
Naturalmente, la mayoría de las aplicaciones y servicios creados y que se ejecutan en la nube se basan en API REST:
- REST (= Transferencia de estado representacional)
- es un estilo arquitectónico que define ciertas directrices y restricciones sobre cómo diseñar componentes en la web. En particular, hace hincapié en la interacción y comunicación de dichos componentes.
- API (= Interfaces de programación de aplicaciones)
- define cómo otros componentes pueden contactar con los componentes para desencadenar determinadas funciones o intercambiar datos.
Una API REST (también RESTful API) es una API que se adhiere a las directrices y restricciones definidas por el estilo arquitectónico REST.
Los usuarios finales normalmente no acceden directamente a las API REST de aplicaciones y servicios en la nube. Principalmente utilizan una aplicación que proporciona una interfaz gráfica de usuario (GUI) y compone información relevante de otras aplicaciones y componentes en la nube, haciendo uso de API REST. Por lo tanto, las API REST están ocultas para el usuario final. Pero esto puede ser diferente para los desarrolladores o administradores, ya que es posible que deseen utilizar o probar la funcionalidad que no proporciona una aplicación con GUI.
Durante el proceso de desarrollo, el desarrollador puede necesitar probar o simular funcionalidades individuales de determinados componentes independientemente de otros componentes que son relevantes para el sistema o la arquitectura en general. Por ejemplo, el desarrollador está trabajando en un nuevo proceso para la aprobación de solicitudes de ausencia. En el escenario productivo, se supone que el proceso lo desencadena una aplicación desarrollada por otro equipo. La aplicación llamará una API REST de SAP Build Process Automation para desencadenar el proceso de aprobación de ausencias. Como la aplicación aún no existe, el desarrollador desea desencadenar la API REST manualmente durante el proceso de desarrollo para realizar pruebas. Para ello, pueden hacer uso de un cliente REST.
Un cliente REST es una herramienta que simplifica la comunicación técnica con las API REST. Proporciona una interfaz para los protocolos de comunicación técnica necesarios, como HTTPS, y facilita su uso.
Otro rol que puede estar interesado en clientes REST en el contexto de SAP Build Process Automation es el operador o administrador. Este rol administra, procesa y puede que necesite realizar tareas irregulares de vez en cuando. Pueden ser tareas de limpieza, por ejemplo. Muchas funciones de administración y operación de SAP Build Process Automation están disponibles a través de las aplicaciones "Supervisar instancias de proceso y flujo de trabajo" y "Gestionar procesos y flujos de trabajo", pero algunas funciones solo pueden estar disponibles a través de su API REST.
Descubrir las API de SAP Build Process Automations en SAP Business Accelerator Hub
Al introducir SAP API Business Hub (enlace que se sustituirá en breve) y buscar el producto SAP Build Process Automation, encontrará el paquete de API correspondiente. A continuación, encontrará las diferentes API que contiene y un ejemplo de cada una de ellas sobre cómo se podrían aprovechar estas API.
- Ejecución de automatización
- Cree una aplicación que le permita iniciar automatizaciones específicas haciendo clic en un botón.
- Supervisión de automatización
- Recuperar los logs de ejecuciones de automatización anteriores y administrarlos en otra herramienta.
- Decisiones
- Ejecute un servicio de reglas utilizando un cliente REST para probar que produce los resultados esperados.
- Bandeja de entrada
- Cree una aplicación de bandeja de entrada personalizada que tenga un aspecto diferente al de la aplicación estándar Mi bandeja de entrada suministrada por SAP. Este caso de uso también requeriría la API Procesos y flujos de trabajo.
- Workflows
- Deje que otra aplicación desencadene nuevas instancias de proceso o de workflow.
- Escenarios de visibilidad
- Obtenga visibilidad de los procesos o flujos de trabajo en sistemas que no son de SAP enviando eventos de procesos al servicio SAP Build Process Automation.
- Área de trabajo de visibilidad
- Obtener un resumen de los escenarios de visibilidad a los que tiene acceso un usuario específico.
Búsqueda de un punto final para utilizar
Supongamos que desea descubrir cómo desencadenar un nuevo proceso o instancia de flujo de trabajo con las API de SAP Build Process Automation.
En el paquete API de SAP Build Process Automation, seleccione la API REST de flujos de trabajo. Obtendrá un resumen y una descripción de la API REST.
Seleccione Referencia de API para ver los detalles de los diferentes puntos finales de API que proporciona.
Seleccione Instancias de flujo de trabajo y, a continuación, el punto de acceso POST para iniciar nuevas instancias.
Ahora puede ver los detalles del punto final correspondiente. Esta vista es especialmente importante porque también proporciona detalles sobre los roles o alcances necesarios para ejecutar la API y sobre los parámetros necesarios al llamar la API. En el siguiente ejercicio, obtendrá información sobre los pasos necesarios exactos al utilizar una API de SAP Build Process Automation.
