Definición de parámetros para una vía de acceso

Los parámetros de vía de acceso pueden especificar elementos variables de una vía de acceso de URL, parámetros de consulta, cabeceras o un cuerpo de solicitud. Los parámetros se aplican a todas las operaciones definidas bajo la vía de acceso. Un parámetro de vía de acceso puede alterarse temporalmente en el nivel de operación, pero no puede eliminarse allí.

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 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 acceso.
  3. Expanda la vía de acceso necesaria y, si ya hay uno o varios parámetros definidos, expanda Parámetros.
  4. Puede crear un parámetro o editar cualquier parámetro existente.
    • Para crear un parámetro, pulse el icono Añadir OpenAPI 3.0 Icono de adición de API junto a Parámetrosy, a continuación, consulte Creación de un parámetro.
    • Para editar un parámetro existente, pulse el nombre del parámetro en el panel de navegación y, a continuación, consulte Edición de un parámetro.