Editing an encoding definition

An encoding definition defines a map between a specific schema property and its encoding information

Before you begin

Open the details form for an encoding definition when configuring a content definition; see Editing a content definition.

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 by clicking the Source icon OpenAPI Source icon. To return to the design form, click the Form icon Form icon.

Procedure

  1. Provide the following information:
    • Name: The name of the schema property. To change the name, click Update, then click Save when done.
    • Content Type: The Content-Type for encoding the property; for example:
      • application/xml; charset=utf-8
      • image/png, image/jpeg.
    • Headers: A map allowing additional information to be provided as headers.

      To add a new header, click Add, then refer to Creating a header.

      To edit an existing header, click the header name, then refer to Editing a header.

    • Style: Describes how the property value will be serialized depending on the type of the property value. Select one of the following options:
      • form: Form style properties defined by RFC6570.
      • spaceDelimited: Space separated array values.
      • pipeDelimited: Pipe separated array values.
      • deepObject: Provides a simple way of rendering nested objects using form properties.
    • Explode: When selected, property values of type array or object generate separate properties for each value of the array or key-value pair of the map.
    • Allow Reserved: Determines whether the property value should allow reserved characters, as defined by RFC3986 (:/?#[]@!$&'()*+,;=) to be included without percent-encoding.
  2. Click Save when done.

What to do next

If required, use the breadcrumb trail to navigate to another location in the hierarchy of the object you are working on.