Cuando se usa el generador de integraciones, se pueden pasar los parámetros de solicitud de tipos como cadena, número, booleano y matriz en el cuerpo de la solicitud de API. Esta funcionalidad da más flexibilidad en las integraciones de API y facilita una gama mucho más amplia de casos de uso. En este artículo se explica cómo configurar estos parámetros.
Los temas tratados son estos:
- Configurar el tipo de parámetro en los parámetros de solicitud
- Agregar un cambio de formato para los parámetros de matriz
- Usar parámetros en el cuerpo de la solicitud de una llamada de API
- Probar la configuración
Artículo relacionado:
Configurar el tipo de parámetro en los parámetros de solicitud
Para configurar el tipo de parámetro en los parámetros de solicitud
- Vaya a la sección Parámetros de solicitud en el generador de integraciones.
- Defina el parámetro y seleccione uno de los tipos siguientes:
- Cadena: para datos textuales que van entre comillas (como "texto de ejemplo").
- Número: para valores numéricos (por ejemplo, 123).
- Booleano: para valores verdadero o falso.
-
Matriz: para una colección de valores (por ejemplo, ["elemento1", "elemento2"]).
Agregar un cambio de formato para los parámetros de matriz
Al hacer pruebas en el generador de integraciones con parámetros de tipo matriz, es importante que agregue una función para cambiarles el formato, ya que solo así se podrán manejar correctamente. Para ello, utilice la siguiente función:
$eval($)
Esta función analiza el valor de la cadena y la convierte en un objeto matriz.
Si el parámetro ya es un objeto matriz, la función no altera su comportamiento.
Si desea más información, consulte Cambiar el formato de los valores en los parámetros de solicitud para los agentes IA.
Usar parámetros en el cuerpo de la solicitud de una llamada de API
En el cuerpo de la solicitud de la llamada de API, estos parámetros se pueden usar en el mismo formato que los parámetros de cadena usando esta sintaxis: {{<REQUEST_PARAMETER>}}
Si bien el parámetro puede verse como una cadena en el cuerpo (como se aprecia en la captura de pantalla que sigue), durante la ejecución se transforma en el tipo de datos especificado en la sección Parámetros de solicitud.
Probar la configuración
Use el botón Probar Producción del generador de integraciones para ejecutar una llamada de API.
Verifique que los parámetros se pasen con el tipo correcto (cadena, número, booleano y matriz) en la solicitud.
Examine la respuesta para asegurarse de que la API está manejándolo todo correctamente.