Definición de parámetros para una operación

Para la vía de acceso de URL asociada con una operación específica, los parámetros de operación pueden definir elementos variables de la vía de acceso de URL, parámetros de consulta, cabeceras o parámetros de cuerpo.

Acerca de esta tarea

Nota:
  • Esta tarea está relacionada con la configuración de una definición de API OpenAPI 3.0. Para obtener detalles sobre cómo configurar una definición de API de OpenAPI 2.0 , consulte Edición de una definición de API de OpenAPI 2.0.
  • Las API de OpenAPI 3.0 solo están soportadas con DataPower® API Gateway, no con DataPower Gateway (v5 compatible).
  • Para obtener detalles sobre las limitaciones actuales del soporte de OpenAPI 3.0 , consulte el soporte de OpenAPI 3.0 en IBM® API Connect.

Puede completar esta tarea utilizando la aplicación de interfaz de usuario de API Designer o utilizando la interfaz de usuario de API Manager basada en navegador.

Un parámetro de operación altera temporalmente un parámetro con el mismo nombre definido en la vía de acceso padre; consulte Definición de parámetros para una vía de acceso.

Un parámetro es similar a una cabecera, con las diferencias siguientes:
  • Los parámetros transportan datos reales y están disponibles para los usuarios finales, mientras que las cabeceras transportan metadatos asociados con una solicitud o respuesta y están ocultas a los usuarios finales.
  • Un parámetro puede tener varias ubicaciones, mientras que la ubicación de una cabecera se establece siempre en header.
  • Un parámetro puede tener varios estilos de formato, mientras que el estilo de una cabecera es siempre simple.
Para obtener más información sobre las cabeceras, consulte Creación de una cabecera.

En cualquier momento, puede conmutar directamente al origen YAML OpenAPI subyacente pulsando el icono Origen Icono OpenAPI Source. Para volver al formulario de diseño, pulse el icono Formulario Icono de formulario.

Procedimiento

  1. Abra la API para editarla, tal como se describe en Edición de una definición de API de OpenAPI 3.0.
  2. Expanda Vías de accesoy, a continuación, expanda la vía de acceso necesaria.
  3. Expanda Operacionesy, a continuación, expanda la operación necesaria.
  4. Puede crear un parámetro de operación o editar cualquier parámetro existente.
    • Para crear un parámetro de operación, pulse el icono añadir OpenAPI 3.0 Icono de adición de API junto a Parámetroy, a continuación, consulte Creación de un parámetro.
    • Para editar un parámetro de operación existente, pulse el nombre del parámetro en el panel de navegación y, a continuación, consulte Edición de un parámetro.