Saltar al contenido principal
Docs
Ir al Studio
Roberty Studio
RPAAPI

Solicitud de API

Solicitud de API

Realiza una solicitud HTTP a una URL externa, admitiendo los principales métodos (GET, POST, PUT, DELETE, OPTIONS) y permitiendo configurar los encabezados y el cuerpo de la solicitud.


Opciones​

URL de la solicitud​

Indica la URL completa a la que será enviada la solicitud. Cuando se selecciona un cliente de API con URL base en las configuraciones de la solicitud, puedes informar solo la ruta (ej.: /pedidos).

Selecciona el método de la solicitud​

Selecciona el método HTTP que será utilizado: GET, POST, PUT, DELETE u OPTIONS.

Cuerpo de la solicitud​

Indica el cuerpo (body) de la solicitud. Copia exactamente el contenido esperado por la API de destino.

Encabezado de la solicitud​

Indica los encabezados (headers) necesarios para la solicitud, como tokens de autenticación, tipo de contenido, entre otros.

Cliente de API (opcional)​

Selecciona una acción Crear Cliente de API del flujo para que la solicitud use el certificado de cliente (mTLS), la URL base, los encabezados predeterminados y la autenticación configurados en ella. La acción debe estar en el mismo flujo que esta solicitud, antes de ella. Déjalo vacío para una solicitud común.

Retornos​

Código Javascript​

js
actions["id-de-la-accion"].response    // valor de respuesta de la API (Cualquiera)
actions["id-de-la-accion"].status      // código de estado HTTP (Número)
actions["id-de-la-accion"].statusText  // texto del estado HTTP (Texto)

Selección de campos​

  • response — valor de respuesta de la API (Cualquiera)
  • status — código numérico de estado HTTP, ej.: 200, 404, 500 (Número)
  • statusText — texto descriptivo del estado HTTP, ej.: OK, Not Found (Texto)

Reglas y Condiciones​

  • El campo URL de la solicitud es obligatorio.
  • El método predeterminado es GET en caso de que no se seleccione otro.
  • El cuerpo de la solicitud debe estar en el formato esperado por la API de destino.
  • Con un cliente de API seleccionado, los encabezados repetidos siguen esta precedencia: encabezados predeterminados del cliente < token de autenticación < encabezados de esta solicitud.
  • Con autenticación configurada en el cliente, el token se obtiene y renueva automáticamente; si la API responde 401, la solicitud se repite una única vez con un token nuevo.