Defining operations for a Path

Operations on a Path defines the mechanisms available for interacting with the API when it is called using that Path. An operation can be of various pre-defined types; for example, a POST operation is most commonly used for creating new resources, while a GET operation is used to retrieve a resource.

About this task

Note:
  • This task relates to configuring an OpenAPI 3.0 API definition. For details on how to configure an OpenAPI 2.0 API definition, see Editing an OpenAPI 2.0 API definition.
  • OpenAPI 3.0 APIs are supported only with the DataPower® API Gateway, not with the DataPower Gateway (v5 compatible).
  • For details of current OpenAPI 3.0 support limitations, see OpenAPI 3.0 support in IBM® API Connect.

You can complete this task either by using the API Designer UI application, or by using the browser based API Manager UI.

At any time, you can switch directly to the underlying OpenAPI YAML source that corresponds to the design form in the user interface by clicking the Source icon OpenAPI Source icon. To return to the design form, click the Form icon Form icon.

Procedure

  1. Open the required API for editing, as described in Editing an OpenAPI 3.0 API definition.
  2. Expand Paths.
  3. Expand the required Path, then, if there are one or more operations, expand Operations.
  4. To create an operation, click the add icon OpenAPI 3.0 API add icon alongside Operations under the Path in the navigation pane. To edit an existing operation, click the operation name under the Path in the navigation pane.
  5. Provide the following information:
    • Verb: Select the operation type from the following options:
      1. get
      2. post
      3. put
      4. delete
      5. options
      6. head
      7. patch
      8. trace
    • Summary: A summary of what the operation does.
    • Description: A description of the operation behavior. You can use CommonMark syntax for rich text representation.
    • Operation ID: Unique string used to identify the operation. The id must be unique among all operations described in the API.
    • Deprecated: Declares this operation to be deprecated. Consumers should refrain from using the declared operation.
  6. If you are creating a Path operation, click Create.
  7. Click Save when done.