Cuando agregue una acción manualmente, deberá configurar los detalles de la acción agregando la ruta y los parámetros de consulta, los encabezados, las solicitudes y la respuesta.

Cuando importe una definición de API, deberá verificar y editar los detalles de la acción para asegurarse de que la acción tenga los valores adecuados según sus requisitos. Estos detalles se mostrarán en el editor de Bot editor o API Task al utilizar el paquete. Cuando agrega una acción, se muestra la página de configuración de Acciones. La pestaña Configuración muestra varias configuraciones y la pestaña Prueba le permite probar la acción. Las siguientes configuraciones están disponibles en la pestaña Configuración.

Configuraciones de la pestaña Configuración

Método HTTP
Especifique el tipo de solicitud REST que debe enviar al servidor de la API REST. Se admiten los siguientes métodos HTTP:
  • OBTENER
  • PONER
  • PUBLICAR
  • ELIMINAR
  • PARCHE
Nota: Cuando importa una definición de API, el editor de conectores ignora las acciones con métodos no compatibles e incluye el resto en el conector personalizado.
Punto final
Ingrese la URL del punto de conexión que se utilizará para esta acción. El usuario del paquete no puede ver esta URL. Utilice llaves {} para encerrar la ruta y los parámetros de consulta en la URL. Por ejemplo, /{version}/product/{productid}?status={productStatus}.
URL completa
Este campo de solo lectura muestra el campo generado automáticamente que combina la URL base que usted ingresa al crear el paquete y la URL de punto final del campo Punto final. Esta URL no será visible para el usuario del paquete.
Parámetros de solicitud
Los parámetros de solicitud le permiten identificar, ordenar y filtrar las respuestas del servidor de la API. Utilice la opción Agregar parámetro para añadir parámetros de solicitud. Puede agregar parámetros de ruta y de consulta. Asegúrese de que los parámetros coincidan con la ruta URL de Punto final. Para obtener más información sobre cómo agregar parámetros de solicitud, consulte Parámetros de solicitud.
Encabezados de solicitud
Los encabezados de solicitud le permiten agregar información adicional a la solicitud. Puede agregar encabezados de solicitud como Aceptar, Largo del contenido, Tipo de contenido y Cookie. Para obtener más información sobre cómo agregar encabezados de solicitud, consulte Encabezados de solicitud.
Cuerpo de la solicitud
La opción Cuerpo de la solicitud le permite importar una carga útil de muestra para definir la estructura del cuerpo de la solicitud. La carga útil es la información real que se requiere para crear, actualizar o eliminar un recurso en el servidor de la API. Cuando se ejecuta la acción, la solicitud incluye este contenido. Para obtener más información sobre cómo agregar el cuerpo de la solicitud, consulte Cuerpo de la solicitud.
Estas son las opciones disponibles:
  • JSON: Seleccione esta opción para importar una muestra JSON a fin de asignar los atributos del cuerpo de la solicitud. Los nodos hoja se capturarán y mostrarán aquí como una lista de atributos. JSON brinda flexibilidad con su estructura de pares clave-valor. Para obtener más información sobre la opción JSON en el cuerpo de la solicitud, consulte JSON.
  • Datos del formulario: Seleccione esta opción para agregar parámetros de datos de formulario como atributos del cuerpo de la solicitud. La opción Datos de formulario es útil para subir archivos al servidor de la API REST especificando el tipo de contenido. Para obtener más información sobre la opción de datos de formulario, consulte Datos de formulario.
  • Datos codificados en la URL del formulario Seleccione esta opción para agregar parámetros de cuerpo de solicitud en el formulario HTML como pares clave-valor codificados en URL, similar a los parámetros de solicitud de tipo consulta. Para obtener más información sobre datos codificados Datos codificados en URL del formulario, consulte Datos codificados en URL del formulario
Respuesta
La opción Respuesta le permite importar una carga útil de muestra de la respuesta y elegir los atributos que desea mostrar en el editor de Bot editor y API Task. Para obtener más información acerca de cómo agregar un parámetro de respuesta, consulte Respuesta